On macOS, Zen Browser's beautiful transparency/vibrancy effect only works when the window is focused. When you switch to another app, the transparency disappears and the window becomes opaque gray.

This Frida script hooks into macOS's window management to make Zen Browser think it's always focused, keeping the transparency effect active at all times.

Before installing the patch, you must configure Zen Browser settings:

1. Open Zen Browser
2. Navigate to about:config in the address bar
3. Set the following preferences:
   • browser.tabs.allow_transparent_browser → true
   • zen.view.grey-out-inactive-windows → false

⚠️ Important: These settings are required for the transparency patch to work correctly.

The following Zen Browser extensions must be installed and configured:

• 🎨 Transparent Zen extension
• 🌐 Zen Internet extension

⚠️ Important: Both extensions are required for the transparency patch to function properly.

1. Restart your Mac and hold Command + R to enter Recovery Mode
2. Open Utilities > Terminal
3. Run: csrutil disable
4. Restart your Mac

⚠️ Warning: Disabling SIP reduces system security. Re-enable after use if needed.

pip3 install frida-tools

git clone https://github.com/hmmhmmhm/zen-transparency-patch.git
cd zen-transparency-patch
sudo ./install-daemon.sh

The installer will:

• ✅ Automatically detect your Frida installation path
• ✅ Set up automatic patching when Zen Browser launches
• ✅ Start the daemon immediately

Open Zen Browser and enjoy the always-transparent vibrancy!

tail -f ~/zen-transparency-patch/patch.log

# Start Zen Browser first, then:
sudo $(which frida) -n zen -l zen-transparency.js

The script hooks into these macOS methods:

This tricks NSVisualEffectView into rendering as if the window is always active, maintaining the beautiful transparency effect.

cd ~/zen-transparency-patch
sudo ./uninstall-daemon.sh

To re-enable SIP:

1. Restart in Recovery Mode (Command + R)
2. Run: csrutil enable
3. Restart

SIP is not disabled. Check with:

csrutil status
# Should show: disabled

Make sure Frida is installed:

pip3 install frida-tools

Check the logs:

cat ~/zen-transparency-patch/patch.log
cat ~/zen-transparency-patch/daemon-err.log

MIT License - see LICENSE for details.

• 🤖 Created with assistance from Claude (Anthropic)
• 🔧 Uses Frida for dynamic instrumentation
• 🌐 Made for Zen Browser