1
0
Fork 1
mirror of https://github.com/zen-browser/desktop.git synced 2025-07-08 01:19:59 +02:00
🌀 Experience tranquillity while browsing the web without people tracking you!
Find a file
2025-02-01 02:31:05 +00:00
.github Add vertical tab animations and implement stale issue management workflow 2025-01-31 17:26:15 +01:00
.husky Update pre-commit hook and upgrade lint-staged to version 15.3.0 2025-01-04 02:07:53 +01:00
.vscode Fixed addon updates 2024-09-15 13:50:52 +02:00
AppDir Update zen.desktop 2025-01-10 16:30:07 +01:00
build/winsign Refactor macOS build workflow and remove deprecated entitlements files 2025-01-23 12:10:26 +01:00
configs Discard changes to configs/macos/mozconfig 2025-01-29 15:23:54 -08:00
docs Update monthly issue metrics 2025-02-01 02:31:05 +00:00
firefox-cache Update localization commit hashes for Firefox cache and subproject 2025-01-30 00:38:46 +01:00
flatpak Update URLs in Flatpak template and adjust border-radius settings for improved styling 2025-01-20 07:39:41 +01:00
l10n@cb32b48cb5 Update localization commit hashes for Firefox cache and subproject 2025-01-30 00:38:46 +01:00
scripts Fix default value formatting in workflow YAML files and clean up whitespace in update_ff.py 2025-01-30 00:39:11 +01:00
src Refactor sidebar CSS to use variable for margin calculation and remove unnecessary border 2025-02-01 00:24:02 +01:00
.dockerignore Fixed web aligment issues on certain occations and URL bar not showing in compact mode right side 2024-12-17 17:05:50 +01:00
.editorconfig Incorporate '.editorconfig' as a cross-editor configuration to ensure uniformity in code 2024-11-28 07:29:17 +05:30
.gitattributes Refactor unpacking of Windows build tar files 2024-09-16 20:32:04 +03:00
.gitignore Add support for updating the l10n last commit hash and new script option 2025-01-28 16:46:16 +01:00
.gitmodules Translated files to a single monorepo 2024-11-04 17:37:02 +01:00
.nvmrc Add '.nvmrc' and '.python-version' files to ensure system dependency (node) is documented 2024-11-27 23:11:55 +05:30
.prettierignore Enhance compact mode functionality by refining sidebar animation conditions and updating CSS ignore rules 2025-01-25 13:42:52 +01:00
.prettierrc.json Update Prettier configuration and dependencies; add prettier-plugin-sh and upgrade husky and prettier versions 2025-01-04 02:28:08 +01:00
.python-version Add '.nvmrc' and '.python-version' files to ensure system dependency (node) is documented 2024-11-27 23:11:55 +05:30
CODE_OF_CONDUCT.md Refactor CSS and JavaScript files for consistency; clean up whitespace and formatting 2025-01-04 02:21:45 +01:00
CODEOWNERS Update Git configuration and CODEOWNERS to reflect new user details 2025-01-06 21:01:52 +01:00
l10n-last-commit-hash Add support for updating the l10n last commit hash and new script option 2025-01-28 16:46:16 +01:00
LICENSE chore: Update MPL LICENSE link in README.md 2024-07-15 21:57:48 +00:00
package-lock.json Update @zen-browser/surfer dependency to version 1.9.15 and refine macOS build workflows 2025-01-28 14:02:55 +00:00
package.json Update @zen-browser/surfer dependency to version 1.9.16 and adjust macOS signing command 2025-01-28 19:12:08 +01:00
pyproject.toml Update formatting commands in package.json and pyproject.toml; refactor indentation in Python scripts for consistency 2025-01-12 17:01:36 +01:00
README.md Merge branch 'dev' into firefox-135 2025-01-31 07:38:50 -08:00
requirements.txt Add autopep8 configuration and integrate into workflows for code formatting 2025-01-12 16:57:34 +01:00
surfer.json Merge branch 'dev' into firefox-135 2025-01-31 07:38:50 -08:00

Zen Browser

Downloads Crowdin Zen Release builds

Experience tranquillity while browsing the web without people tracking you! Zen is a privacy-focused browser that blocks trackers, ads, and other unwanted content while offering the best browsing experience!

🖥️ Compatibility

Zen is currently built using firefox version 134.0.2! 🚀

  • Zen Twilight - Is currently built using firefox version RC 135.0!
  • Check out the latest release notes!
  • Part of our mission is to keep Zen up-to-date with the latest version of Firefox, so you can enjoy the latest features and security updates!

🤝 Contribution

Zen is an open-source project, and we welcome contributions from the community! Please take a look at the contribution guidelines before getting started!

Issue metrics

We keep track of how many issues are closed at the end of the month in docs/issue-metrics. This is to keep track of how many issues are being closed, because who doesn't like to see progress? 📈

Versioning

Zen uses Semantic Versioning for versioning. Meaning, versions are displayed as a.bc.d where:

  • a is the major version
  • b is the minor version
  • c is the branch prefix
  • d is the patch version

Branches

Zen is divided into 2 main branches. We use dev for development and stable for stable releases. The dev branch is where all the new features are added and where twilight builds are generated. The stable branch is where the stable releases are generated.

We divide into 2 branches in case there's any really important security update (for example) that needs to be released before the next stable release. This allows us to do patches without releasing unstable versions to the public.

Performance

Zen is built with performance in mind, and we have optimized the browser to be as fast as possible! Checkout the latest performance benchmarks!

📥 Installation

Supported Operating Systems

Zen is available for Linux, macOS, and Windows. You can download the latest version from the official website at zen-browser.app, or from the GitHub Releases page.

If you dont see your OS listed below, that's because we already have it in our downloads page! Make sure to check it out!

Windows

Winget
winget install --id Zen-Team.Zen-Browser

macOS

  • Requires macOS 10.15 or later
  • Available for ARM and Intel architectures

You can also install Zen using Homebrew:

brew install --cask zen-browser

Linux

Arch-based distributions
yay -S zen-browser-bin
Other Linux distributions (AppImage with automated system integration)
  • native tarball install: bash <(curl -s https://updates.zen-browser.app/install.sh)

  • zsync is required for the Update feature of the script below

bash <(curl https://updates.zen-browser.app/appimage.sh)
  • Again, if you don't see your OS listed above, that's because we already have it in our downloads page! 🔄

To upgrade the browser to a newer version, use the embedded update functionality in About Zen.

👨‍💻 Development and Contributing

Some components used by @zen-browser as an attempt to make firefox forks a better place, and for other to enjoy the beauty of OSS. You can find them here.

Run Locally

In order to download and run zen locally, please follow these instructions.

Special Thanks

Special thanks to... EVERYONE 🎉! Checkout the team and contributors page here

Third Party Code

Zen couldn't be in its current state without the help of these amazing projects! 🙏

🖥️ Comparison with other browsers

Thanks everyone for making zen stand out among these giants!

Star History Chart

📄 License

Zen browser is under the MPL LICENSE. All the code is open-source and free to use! Attributions are appreciated but not required.