This post is the README from FluentFox, synced from GitHub. Click the project card on the Projects page to open the repo.

FluentFox

#

Transparent Firefox — browser chrome + per-site website styles — inspired by Zen Browser’s Transparent Zen + Zen Internet combo.

FluentFox is two pieces that work together:

┌────────────────────────────┐
│  Firefox chrome (theme)    │  ← translucent toolbars / tabs
│  ┌──────────────────────┐  │
│  │  Web page            │  │  ← FluentFox extension + my-internet styles
│  └──────────────────────┘  │
└────────────────────────────┘

Requirements

#

• Firefox 115+ (vertical tabs: Firefox 136+ with sidebar layout)
• OS support for window transparency/blur varies (see Platform notes)

Install

#

1. Browser theme

#

macOS / Linux

./theme/install.sh

Windows (PowerShell)

.\theme\install.ps1

Then:

1. Quit Firefox completely and reopen (prefs in user.js apply on startup).
2. Open about:addons → Themes → use System theme — auto or Firefox Default (third-party themes often paint opaque backgrounds).
3. Optional: enable Vertical tabs under Settings → General → Browser Layout — the same CSS covers both layouts.

The installer finds your default profile via profiles.ini, copies chrome/userChrome.css, chrome/userContent.css, and user.js, and keeps timestamped *.fluentfox-backup-* copies of anything it replaces.

2. Extension (temporary load)

#

AMO / signed .xpi distribution is not set up yet. For now:

1. Open about:debugging#/runtime/this-firefox
2. Click Load Temporary Add-on…
3. Select extension/manifest.json
4. Visit a supported site (YouTube, GitHub, Reddit, …) and open the FluentFox toolbar popup to toggle features

Temporary add-ons are removed when Firefox restarts — reload the same way after each restart until a signed build is published.

Dev helpers

cd extension
npx web-ext lint
npx web-ext run

Uninstall

#

Theme

1. Delete (or restore backups of) in your profile folder:
   • chrome/userChrome.css
   • chrome/userContent.css
   • user.js
2. In about:config, set browser.tabs.allow_transparent_browser → false
3. Restart Firefox

Important: that pref is not reset automatically. Leaving it true after removing the theme can make some pages look oddly transparent.

Extension

• Temporary: restart Firefox, or remove it from about:debugging
• Later (AMO): remove from about:addons

Platform notes

#

Dark Reader can help on sites that stay light-themed after transparency is applied.

Requesting site styles

#

Styles ship from upstream sameerasw/my-internet. Use the extension’s Request Theme flow, or open an issue there. FluentFox does not maintain a separate styles fork — updates arrive when the extension refreshes styles.json (about every 2 hours with auto-update on).

Repo layout

#

FluentFox/
├── extension/          # FluentFox WebExtension (fork of Zen Internet)
├── theme/
│   ├── chrome/
│   │   ├── userChrome.css
│   │   └── userContent.css
│   ├── user.js
│   ├── install.sh
│   └── install.ps1
├── LICENSE
└── README.md

Credits

#

• Zen Internet (sameerasw) — extension base, MIT
• Transparent Zen (frostybiscuit) — original addon base / inspiration, MIT
• my-internet — site CSS library, MIT
• Transparent Firefox community themes (gwfox, MicaBlur-Firefox, and others) — chrome selector patterns

License

#

MIT — see LICENSE. Upstream licenses and the vendored commit hash are recorded in extension/UPSTREAM.md.