zen-desktop README

The project's README from github.com/irbis-sh/zen-desktop. As one markdown file: README.md.

Zen's Blue Shield Logo

Zen: Your Comprehensive Ad-Blocker and Privacy Guard

There is, simply, no way, to ignore privacy. Because a citizenry’s freedoms are interdependent, to surrender your own privacy is really to surrender everyone’s.

Edward Snowden, Permanent Record

GitHub License GitHub release GitHub download counter

Website • Mastodon • Bluesky • Discord • Documentation

Zen is an open-source system-wide ad-blocker and privacy guard for Windows, macOS, and Linux. It works by setting up a proxy that intercepts HTTP requests from all applications, and blocks those serving ads, tracking scripts that monitor your behavior, malware, and other unwanted content. By operating at the system level, Zen can protect against threats that browser extensions cannot, such as trackers embedded in desktop applications and operating system components. Zen comes with many pre-installed filters, but also allows you to easily add hosts files and EasyList-style filters, enabling you to tailor your protection to your specific needs.

Downloads

During the first run, Zen will prompt you to install a root certificate. This is required for Zen to be able to intercept and modify HTTPS requests. This certificate is generated locally and never leaves your device. For details on how this works and the steps we take to secure it, see our security architecture.

Windows

Unsure which version to download? Click on 'Start' and type 'View processor info'. The 'System type' field under 'Device specifications' will tell you which one you need.

Winget

Zen is available via Winget (Windows Package Manager). To install, run:

winget install ZenPrivacy.ZenDesktop

macOS

Unsure which version to download? Learn at Apple's website.

🍺 Homebrew

Zen is available via Homebrew for both Intel and Apple Silicon. To install it, run:

brew install --cask zen-privacy

Linux

Zen has an install script that covers most Linux distributions. To install, run:

curl -fsSL https://raw.githubusercontent.com/irbis-sh/zen-desktop/master/install.sh | sh

To uninstall, run:

curl -fsSL https://raw.githubusercontent.com/irbis-sh/zen-desktop/master/install.sh | sh -s -- --uninstall

Other installation methods:

On Linux, automatic proxy configuration is currently only supported on GNOME- and KDE-based desktop environments.

Screenshots

Request history Filter list manager
Request history shows all requests blocked by Zen. Each request can be inspected to see which filter and rule blocked it. Zen comes with many pre-installed filters. You can also add your own by providing a URL to a hosts file or an EasyList-style filter.
Screenshot of Zen's Home screen showing blocked network requests. One entry details a blocked request to a Marketo tracking script from politico.com, with several other advertising and analytics domains listed below. Navigation tabs and a Donate button appear at the top, and a blue Stop button is visible at the bottom. Screenshot of Zen's Filter lists screen showing a regional category with multiple ad-block filter lists from different countries. Each list includes a name, a source URL, and toggle switches indicating whether it is enabled.

Development

Follow the getting started guide to begin working on Zen development. If you have any questions, feel free to ask in the Discussions.

Contributing

Zen needs your help! You can report bugs, suggest and implement features, improve the codebase, or help translate Zen into your language. Please refer to the Contributing Guidelines for more information.

Special Thanks

Zen exists thanks to the support of many incredible people and organizations, including:

License

This project is licensed under the MIT License. Some code and assets included with Zen are licensed under different terms. For more information, see the COPYING file.

zen-desktop (irbis-sh/zen-desktop)

Searching Database…

4.3K ·GitHub
Zen-desktop
这是什么?Zen 是一款开源的系统级广告拦截和隐私保护工具,支持 Windows、macOS 和 Linux。它能在所有应用程序中拦截广告、跟踪器和恶意软件,而不只是浏览器。
这不就是一个普通的浏览器扩展吗?不是。它以桌面应用的形式运行,会设置一个本地代理,拦截系统中所有应用发出的 HTTP/HTTPS 请求,因此可以拦截桌面软件和操作系统组件里的跟踪器,这是浏览器扩展做不到的。
需要额外安装什么东西才能用吗?首次运行时,Zen 会让你安装一个本地生成的根证书,用于拦截并解密 HTTPS 流量;这个证书不会离开你的设备。
自动设置代理在所有 Linux 桌面上都一样好用吗?不一样。在 Linux 上,自动代理配置目前只支持基于 GNOME 和 KDE 的桌面环境;其他环境可能需要手动配置。
支持哪些 CPU 架构?Zen 在 Windows 和 macOS 上提供 x64(Intel)和 ARM64(包括 Apple Silicon)的独立版本,在 Linux 上还提供 x64/ARM64 的便携版。
解密 HTTPS 用的证书会被发送到别处吗?不会。Zen 安装的根证书是在你电脑上本地生成的,永远不会离开你的设备。
我可以自定义 Zen 拦截哪些内容吗?可以。除了内置的过滤规则之外,你还可以添加自己的 hosts 文件或 EasyList 风格的过滤规则链接,按自己的需求调整拦截效果。
我能看到 Zen 拦截了什么吗?可以。请求历史页面会显示每一条被拦截的请求,还能查看是哪条过滤规则拦截的。
Zen 是用什么语言写的?Zen 是用 Go 写的。
What are similar projects?glasshouse, anti-AD, DnsServer, Arachnidium, CCBaga, whoogle-search, dnscrypt-proxy, RemoveMacAI
Which topics is it in?adblocker, ad-blocker, adblock, arm64, privacy-tools, homebrew, apple-silicon, proxy, networking, go, gui, privacy
Creator
irbis-sh
Size
10.5 MB
Stars
4.3K
Updated
CommitOct 14Releasev0.27.1Oct 12
Age
3y
Commits · 90 Days