Skip to content

Instantly share code, notes, and snippets.

@georg-stone
Last active January 25, 2025 15:06
Show Gist options
  • Save georg-stone/3baedb8996043b71b8eeac300c67fe2b to your computer and use it in GitHub Desktop.
Save georg-stone/3baedb8996043b71b8eeac300c67fe2b to your computer and use it in GitHub Desktop.
A guide to Zen Browser

Zen is a new and interesting browser. This is a full guide to it.

Installing

To install it, just go to zen-browser.app and install for your platform. After that, open it and complete the onboarding process.

Syncing

Right after you install Zen Browser, you should probably log into a Firefox account. If you already have one, then your data should be imported, and if you don't, you'll still get syncing for bookmarks and tabs.

Privacy and Security

Zen comes with a pretty good user.js file, so you shouldn't have to edit that, but in the settings, there are things you should change for privacy.

uBlock Origin

If you don't have this already, get it! This is the most important for your privacy. It blocks malware, trackers, and ads.

Tracker Protection

Head to the Privacy settings and turn on Tracker Protection to Max.

Password Management

A password manager is essential for your security. If you already are using a good one, turn off all the password management stuff in the settings. If you are using Firefox's built-in password manager, at least set a master password.

Secure DNS

In the settings I recommend you turn on Secure DNS. Most people will be fine with Cloudflare's as it won't break anything.

Customization

Zen Mods are basically stackable themes for Zen. All of them are open-source. You should check out these for starting out:

Better Active Tab

https://zen-browser.app/mods/d8b79d4a-6cba-4495-9ff6-d6d30b0e94fe

Hide Extension Name

https://zen-browser.app/mods/cb15abdb-0514-4e09-8ce5-722cf1f4a20f

SuperPins

https://zen-browser.app/mods/ad97bb70-0066-4e42-9b5f-173a5e42c6fc

Space Theme Picker

To change the theme of your space, you can right-click the sidebar and click Change Theme Colors. After that you can pick a solid color or a gradient. The limits are very flexible, and unlike Arc, you can choose any color(s) you want!

Workspaces

Workspaces are basically profiles but in the same window. You can easily switch between them without separate windows. By default, you are already in the Default workspace.

To change and create them, click the space title and you can press Plus to create a new workspace. You can also bind keys in the settings for easy switching.

Zen Glance

Zen has a feature where you can easily preview a link without creating a new tab. To use it, Alt+Click on a link.

It might be disabled for you. Check the settings to see if it's enabled.

Toolbars

Zen offers different toolbar options to choose from. You can have the URL on the sidebar with your tabs or the URL bar at the top.

You can see them all in the Zen settings.

New Tab

Unlike Arc, Zen actually lets you see your New Tab instead of removing it entirely. Because of this, there are options to make it look a lot better and add new features to it. I can recommend:

Tabliss - open-source highly customizable New Tab with widgets Bonjourr - beautiful, light-weight New Tab page Flowtide - beautiful, customizable New Tab page that happens to be created by me :)

Split View

Like Arc, Zen offers an expansive split view option for seeing multiple tabs in one window. To use it, control or command click the tabs you wanna split and press "Split tabs". After that, an icon in the URL bar will appear which lets you customize it.

It is very limitless. I was able to successfully split 19 tabs in one window. That's the beauty of open-source.

Tabs on the right

An underrated Zen feature, you can put your tabs on the right side of the screen. To do so, just right click the sidebar and click "Tabs on the right".

A terrible Firefox behavior you can fix easily

One terrible thing Firefox ships with is a prompt asking if you want to download a file every time. To fix this awful behavior, you can go to Settings and say Zen should always just download the file and shut up.

Proxy

At the bottom of the Settings page, you can configure a proxy just for the browser.

Tab unloading

By default, Zen unloads unused tabs to save resources. If you have a tab that needs to run in the background, you can right-click the tab and select "Tab unloader actions" and prevent the tab from being unloaded.

Declutter the UI

Most Zen Browser toolbar icons can be moved or deleted. Just right click it and remove from toolbar.

The end

Zen is a very customizable browser with lots of features and is rapidly improving. Since it is still in beta, things might be broken and have bugs. If you find one, please report it so Zen can be improved for everyone. Remember, this is an open-source project.

Suggest improvements to this guide by commenting and mentioning me. I'll try to keep this updated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment