Got any issues?

</aside>

<aside> 💡

1. Install the Transparent Zen mod

Then go to mod settings
Enable the “Allow zen browser to be transparent” option, quit and re-open the browser

</aside>

<aside> 💡

Open the addon window and fetch latest themes. Optionally enable themes auto update so you will get new and updated themes automatically as I update the themes repository.

</aside>

<aside> 💡

<aside> 💡

At the moment, only some of the operating systems are known to support transparency. Here are some:
- macOS
- Windows 11 - native mica and acrylic
- Windows 11 - With mods like
- Wayland on KDE
- Hyperland - missing instructions, but possible
Some operating systems are known to not support or unknown.
- Windows 10 - no support even with 3rd party tools
- Gnome - Unknown, mostly blur is a nightmare on gnome.
Make sure your OS already have transparency before we start the process on the sidebar(not compact) and window borders. If not, something else is causing the transparency to now work that you have to figure out.
Check your power saving settings and make sure that’s off on Windows.
Make sure your Windows color settings are not affecting transparency.
Check what mods are you using, mods like better letterboxing, custom themes can affect transparency.
Your zen theme might be overriding transparency. Adjust the contrast slider to gain enough transparency.
Still having issues? reach me out on any social or in any of my community groups for support 🙂

</aside>

<aside> 💡

Once you start browsing, Check the add-on pop-up on each website and you will see a list of features along with transparency. If you don’t like anything, You can toggle it… Keep in mind that disabling any feature or entire theming may need a reload at the current state. I am working on to improve this behavior.

</aside>

<aside> 💡

Don’t see transparency for your favorite website? Request a theme and when I get some free time and if I have access tot hat website, I will manually write and add a css style for that website. Use the built-in button to create a theme request in GitHub for the active website.
You can report bugs and theme issues from the addon as well.
Restricted websites and pages can not be themed and your requests will be closed. Use userContent.css modifications to apply themes for them. Here are some unsupported websites and urls.
- Mozilla addons store
- Seetings
- New tab page
- Addon generated pages
- PDF viewer
- …. other custom urls
Theme contributions are welcome, check the readme in the themes repository for a guide.

CleanShot 2025-04-11 at 7 .28.24@2x.png

CleanShot 2025-04-11 at 7 .29.42@2x.png

</aside>

<aside> 💡

This is for websites that does not have a theme built to get transparency. In that case, you can use the force theming option to apply a wildcard theme trying to achieve transparency for the website. This will also include darkreader support by default to add transparency for websites without a native dark theme. But this also means some elements may break and overlays can have transparent bg but this is out of my control and I don’t wanna write entire new dark themes for the website when the website owners doesn’t even care.
You can force theming in two modes.
- Blacklist mode - all the unsupported websites will get applied and you can manually skip each site.
- Whitelist mode - only selected websites will get applied and switching between modes will invert the selection.

</aside>