Zen Browser

mq1 · September 5, 2024, 12:44pm

The signing issue seems to be resolved

[macOS] Install guide

opened 06:48AM - 13 Jul 24 UTC

closed 07:38AM - 13 Jul 24 UTC

# macOS Installation Guide for Zen Browser ## Initial Setup ### Step 1: Do…wnload the Latest Version 1. Download the [latest Zen Browser DMG](https://github.com/zen-browser/desktop/releases/latest). 2. Once downloaded, open the DMG file. You might need to zoom out a bit to see everything. ![Open DMG](https://github.com/user-attachments/assets/d3a3a845-245e-4154-b6b2-941f4d021bee) ### Step 2: Install Zen Browser 1. Drag the Zen Browser icon to the `Applications` folder. ### Note for Developers If you are the developer of Zen Browser, ensure you include the following icon sizes for macOS, and update the names accordingly: - Black-16.png - Black-32.png - Black-64.png - Black-128.png - Black-256.png - Black-512.png - Black-1024.png These icons serve different purposes, such as the DMG and app icon (1024), Finder icon (128), etc. ### Step 3: Bypass Gatekeeper Upon trying to open Zen Browser, you may encounter a message indicating the file is damaged. This happens because the app does not have a valid developer signature and is using an Ad-hoc sign. ![Gatekeeper Warning](https://github.com/user-attachments/assets/298f06af-772b-460d-9e71-65f6c99e8341) To bypass this warning: 1. Open Terminal. 2. Run one of the following commands: To bypass Gatekeeper for the current installed version: ```sh xattr -c '/Applications/Zen Browser.app/' ``` To bypass Gatekeeper for all versions of the app: ```sh xattr -d com.apple.quarantine '/Applications/Zen Browser.app/' ``` 3. After running the command, if successful, Terminal will return a blank line. ![Successful Command](https://github.com/user-attachments/assets/f80bc340-3032-4c49-936a-c7fc937b8ef9) ### Step 4: Open Zen Browser 1. Open Zen Browser from the Applications folder. 2. Complete the onboarding process. 3. If you use Little Snitch (LS), accept or block any connections as needed, though for a browser, it is generally not recommended to block connections other than telemetry. ### Step 5: Restart Zen Browser At the time of writing, there seems to be a bug with Zen Browser where the menu might not display correctly on the initial start. To fix this, quit Zen Browser (`⌘Q`) and reopen it. ![Incorrect Menu](https://github.com/user-attachments/assets/ae83cf1d-5391-4396-abe7-8b02b31edc85) ![Correct Menu](https://github.com/user-attachments/assets/fb08d7f4-e961-473e-a659-16ecabf76103) You should now have a fully functional Zen Browser on your macOS. If you need to uninstall Zen, you can use [Pearcleaner](https://github.com/alienator88/Pearcleaner).