Crest README

项目的 README,来自 github.com/pauljoda/Crest。合并为一个 markdown 文件:README.md。

Crest app icon

Crest

An open source browser for Mac, iPhone, and iPad.

Built with SwiftUI, running Chromium and WebKit on Mac, with separate Spaces for different parts of your life.

Build Crest Latest release MPL-2.0 license

Visit the product site · Read the guides · Download for Mac · Roadmap · Community

Browse Mac releases by channel: Stable, Nightly, or Development.

Crest on Mac with Lion Work first, Winter Personal second, and Audience research open beside the Launch Atlas folder

A browser with boundaries

Most browsers put every login, tab, and distraction into one long-lived container. Crest begins with Spaces instead. Give work, home, research, or a private session its own banner; Crest gives each one its own cookies, website data, history, archive, tabs, credentials, settings, and sync identity.

Switching Spaces changes more than the color of the window. It changes the browsing context.

When several Spaces should share one set of sign-ins, make them Sub-Spaces: each keeps its own tabs and look while the group shares cookies, history, passwords, and extensions. Read the Sub-Spaces guide.

Two engines on Mac

Crest for Mac opens pages in Chromium by default. Its engine is Chromium with Crest's privacy changes, which keep your browsing, form and account data away from Google, and runs Chrome Web Store extensions. Any website or page can open in WebKit instead, which adds Reader, whole-page translation, built-in content blocking, and FairPlay video. Chromium leaves protected video to WebKit: Netflix, Disney+, Max and Prime Video open in WebKit, and any other page that asks for Widevine or PlayReady video, itself or from a frame of its own site, switches to WebKit automatically, respecting any unsaved-changes prompt before moving it. Choose the default engine and per-website rules in Settings → Engines. iPhone and iPad use WebKit. The engine guide lists what each engine supports.

Crest Studio and Appearance

Crest Studio puts each Space's crest on that Space's own sidebar background. Start from a template, then step through shape, field, band, emblem, border, finish and sidebar, choosing from previews of your own crest. Every part of the crest and the sidebar has its own color, named by what it paints. Use heraldic artwork, emoji, monograms, or a searchable SF Symbols picker, and Shuffle and Undo freely.

Appearance lets you dock the sidebar on either edge, go borderless, adjust tab shape and scale, choose a pin layout, and tune tab and address-field colors, or let them follow each Space's accent. Start with a preset, see changes live, and reset individual settings. Choose an app icon palette, folder colors and icons, and a default page zoom from 50% to 300%.

Crest Studio with a Winter crest on its Space’s sidebar background, its colors, the shape step, and the live sidebar Appearance settings with window, accent, tab, and pin controls

Browsing features

Two pages open side by side in a Split View group in Crest on Mac

Page tools

Capability What it does
On-device translation On iPhone, iPad, and WebKit pages, detect a page’s language, translate it, or show the original. On Chromium pages, translate selected text. Optional automatic translation uses downloaded languages. Apple may ask to download additional languages.
Reader and page tools Read supported articles with fewer distractions on WebKit pages, find text, adjust zoom, share links, copy Markdown links, print, and export PDF or web archives where supported.
Extensions on Mac Install Chrome Web Store extensions in each Space. They run on Chromium pages, with popups and tab-specific side panels. Compatibility varies.
Developer tools on Mac Preview phone, desktop, and custom viewport sizes; capture pages; open Chromium DevTools or Web Inspector for the page's engine. The toolbar appears on localhost, or on any site with Shift-Command-I.
Media Control eligible active media from the sidebar. On Mac, keep supported videos visible with Picture in Picture, including optional automatic PiP.
Downloads and uploads Follow download progress and revisit files in Downloads. Pause and resume Chromium transfers when the server supports recovery. On iPhone and iPad, upload through Photos, camera, or Files.

Privacy and sync

Private Spaces use temporary website storage and stay out of normal history, restoration, and sync. They can require device authentication and relock when Crest leaves the foreground. Crest Passwords keeps origin- and Space-matched credentials in the system Keychain, with authentication for sensitive access.

Site permissions and content blocking are controlled per Space. Built-in ad and tracker blocking covers iPhone, iPad, and WebKit pages; on Chromium pages, install a blocking extension. Closed and cleaned-up tabs go to a recoverable Archive, subject to your retention settings. Keep Loaded protects a page from ordinary unloading when its live state matters.

Optional iCloud sync carries durable Spaces, tabs, folders, Split View groups, appearance, history, and Archive between devices. Password values stay out of CloudKit; eligible passwords can use iCloud Keychain separately. Start a browser import on Mac, review each destination Space, or export a portable Crest archive.

Read the privacy policy, Space isolation guide, and sync guide for the boundaries and controls.

Get Crest

The same Spaces, shaped for each screen. iPad keeps the sidebar beside your page; iPhone gives your tabs and folders their own view.

Lion Work first and Winter Personal second on iPad, with Audience research open The same Spaces, Launch Atlas folder, and selected Audience research tab in the iPhone sidebar

Platform Install
Mac · Apple silicon · macOS 26.1+ Signed, notarized download with built-in Sparkle updates.

Or install via Homebrew:
brew install --cask crest-browser
iPhone · iOS 26.1+ App Store
iPad · iPadOS 26.1+ App Store
iPhone & iPad beta TestFlight

Built as an Apple-platform app

Crest's browser state and rules live in a portable core written in C# and compiled with NativeAOT. The apps are written in Swift and SwiftUI: shared features live in CrestShared, and each platform owns its windows, engine hosting, commands, and adaptive presentation. On Mac, pages render in Chromium by default or in WebKit; iPhone and iPad use WebKit.

CrestCore/       Portable core: session, sync, pages, and browser rules
CrestContracts/  C ABI header and ABI checks for the core library
CrestEngines/    Chromium host overlay, patches, and engine binding
CrestShared/     Domain, application, infrastructure, features, design system
CrestMac/        macOS app and platform-specific presentation
CrestMobile/     iPhone and iPad app and platform-specific presentation

Read the architecture overview for Space isolation, persistence, credentials, synchronization, and the engine boundary.

Build Crest

Requirements:

git clone https://github.com/pauljoda/Crest.git
cd Crest
Scripts/bootstrap.sh
open Crest.xcodeproj

Xcode builds and embeds the self-contained .NET core for Mac, iOS, and Simulator. Its intermediate files stay in Derived Data; the installed app does not require a .NET runtime. The Crest scheme builds the Mac app with WebKit only; releases add a prebuilt Chromium engine, described in the Chromium engine README. See the control-plane build workflow for isolated review builds and Chromium packaging.

project.yml is the source of truth for targets and build settings. Run xcodegen generate after changing source roots, targets, or project configuration.

Releases and updates

Crest 0.9.1 updates Chromium to 157.0.8103.51, which fixes CVE-2026-125350, a security flaw being exploited in the wild. The Crest 0.9 release notes describe Sub-Spaces, built-in ad blocking, and the Chromium engine now built from Chromium itself. Crest requires Apple silicon and macOS 26.1 or later on Mac; iPhone and iPad use WebKit.

When updating from a WebKit-only release, your Spaces, tabs, history, and Crest Passwords carry over. Chromium has separate website storage, so sites may ask you to sign in again. You can keep WebKit as your default. Reinstall older WebKit extensions from the Chrome Web Store in each Space. The upgrade guide explains these changes and the engine feature limits.

macOS releases are distributed directly through GitHub Releases as signed, notarized Apple-silicon disk images, one app with both engines. Crest uses Sparkle 2 with a native SwiftUI update interface. Stable and nightly builds share a signed appcast, and development builds have their own; choosing Nightly or Development is an explicit choice in Settings → About.

GitHub Actions builds every public release, verifies its Developer ID signature and notarization, publishes provenance and checksums, then updates the signed updates branch appcast and that channel's release-note cursor together only after the immutable release assets exist. Public downloads live in GitHub Releases rather than GitHub Packages. See the distribution runbook for the channel, credential, publication, and verification contracts.

Validate a change

Scripts/validate-identity.sh
Scripts/validate.sh
Scripts/validate-cache-hygiene.sh

Run the relevant behavioral tests and repository checks. Review visual, layout, and static-copy changes in the real app, Simulator, or browser.

Project status

Crest is under active development. The current implementation includes the core browsing, Space isolation, native platform chrome, credentials, data portability, synchronization foundations, Quick Window, Peek, and privacy features described above. The Crest Roadmap project is the public release view; approval-gated and physical-device work remains documented in the roadmap.

Community and support

Use r/CrestBrowser for questions, feedback, ideas, and website or extension compatibility discussion. Use GitHub Issues for reproducible bugs and concrete tracked outcomes. Security concerns belong in a private vulnerability report, never a public post. SUPPORT.md explains each route in detail.

Crest is one of several open source projects built by Paul Davis. You can support the work through Ko-fi, Patreon or GitHub Sponsors. Sponsorship does not buy roadmap priority or private access.

Sponsors

Monthly support helps pay for hosting, signing, testing, and development across Paul's open source projects. Sponsors can be recognized in the public sponsor roll at one of three levels:

Every level can also have a sponsor flair on r/CrestBrowser. Recognition is optional. A listing is a thank-you, not an endorsement or a way to buy roadmap priority, private support, or project ownership. See the membership tiers on Ko-fi or Patreon to become a monthly sponsor.

AI usage

AI tools assist with Crest's development, audits, testing, documentation, and project maintenance. Maintainers direct product design and architecture, review generated changes, and remain responsible for everything that ships.

Contributors are welcome to use AI tools. You must understand, review, and validate what you submit, explain your decisions, and address feedback. The same quality standards apply regardless of how a contribution was produced.

Any change an AI tool helped produce must follow the crest-contribution skill. It carries the C# and Swift style, the architecture and UI rules, the test policy, and the pull request requirements that are not obvious from the code. Claude Code finds it through .claude/skills and Codex through .agents/skills; any other agent should start from AGENTS.md, which points to it. The pull request template asks you to confirm the skill was followed, and a check reads that answer. Every pull request also receives an automated CodeRabbit review; treat its comments as a first pass, not a verdict.

Submit only work you can stand behind. AI-generated code, test results, and claims need verification before they become part of a contribution.

Contributing

Want to help? Please do! While I feel confident doing the actual dev work, there are some areas that desperately need help.

Anyone can have one pull request open at a time. To open more, become a vetted contributor: read Who can contribute code and message me on Discord. Please follow the guidelines and make sure your work is well done and aligns with the product. If you have a more drastic change, you can always fork it to try it out, then share it to see whether it would be a good fit to merge in.

See CONTRIBUTING.md for setup and change discipline, GOVERNANCE.md for project ownership, and the documentation index for engineering references. Architecture changes should preserve the Space boundary and the native shape of each platform.

Contributors

People who have contributed to Crest

License and brand

Crest source code is available under the Mozilla Public License 2.0. The source is open for inspection, modification, and commercial use under that license. The Crest name, app icon, logos, and official distribution identity are reserved; modified distributions must use their own branding as described in TRADEMARKS.md. Third-party notices are collected in THIRD_PARTY_NOTICES.md.

Star History

Star History Chart

Crest (pauljoda/Crest)

正在搜索数据库…

1.3K ·GitHub
这是什么?Crest 是一款开源浏览器,适用于 Mac、iPhone 和 iPad,使用 SwiftUI 构建。它将浏览功能划分为独立的“空间”(Spaces),每个空间拥有各自的 Cookie、历史记录、凭据和同步身份。
它使用一个渲染引擎还是两个?在 Mac 上,Crest 使用两个引擎:默认使用 Chromium(基于 ungoogled-chromium,移除了 Google 相关集成),而阅读模式、翻译、内容拦截和受保护视频则使用 WebKit。iPhone 和 iPad 仅使用 WebKit。
我该如何运行 Crest?在 Mac 上,可以从 GitHub Releases 下载经过签名和公证的版本,或运行 'brew install --cask crest-browser'。iPhone 和 iPad 版本可从 App Store 获取,并提供 TestFlight 测试版。
安装前有什么需要注意的吗?Crest 需要搭载 Apple 芯片的 Mac,并运行 macOS 26.1 或更高版本(或 iOS/iPadOS 26.1 或更高版本)——不支持 Windows、Linux 或 Intel 芯片的 Mac,而且 Chrome 网上应用店的扩展仅能在 Mac 的 Chromium 页面中运行。
Crest 只面向 Apple 用户吗?是的——Crest 仅面向 Apple 平台,提供 Mac、iPhone 和 iPad 版本,没有 Android、Windows 或 Linux 版本。
在私密空间中,我的数据会怎样?私密空间使用临时网站存储,不会进入常规历史记录、恢复功能和同步范围,并且可以要求设备验证;密码保存在系统钥匙串中,并排除在 iCloud CloudKit 同步之外。
Crest 中的“空间”到底是什么?空间是一个相互隔离的浏览环境,拥有自己的 Cookie、历史记录、标签页、凭据、设置和同步身份——切换空间会改变整个浏览环境,而不仅仅是窗口颜色。
我能在 Crest 中使用我的 Chrome 扩展程序吗?可以,在 Mac 的 Chromium 页面中,你可以为每个空间分别安装 Chrome 网上应用店的扩展程序,不过兼容性因扩展而异;WebKit 页面以及 iPhone/iPad 上不提供扩展程序。
Crest Studio 是什么?Crest Studio 让你为每个空间的侧边栏设计自定义的纹章“徽标”(crest),可以从模板、SF Symbols、表情符号或你自己的图片中选择形状、底色、饰带、图标、边框和效果。
为什么 Crest 会自动切换引擎?当某个页面需要受保护视频(FairPlay)或其他仅限 WebKit 的功能时,Crest 会先询问是否保存未保存的更改,然后自动将该标签页从 Chromium 切换到 WebKit。
有哪些类似的项目?sill, textream, zulu, ipadn, house-control, NetNewsWire, S2Arm, ExcalidrawZ
作者
pauljoda
大小
77.3 MB
星标
1.3K
时长
3个月
提交 · 90 天