About

My tailor-fitted, highly customized, and advanced Firefox configuration.

Note

This repository is not meant to be used as a whole but rather as a reference for my own configuration. I do not recommend using it as is, as it is not meant to be used by anyone else. I do not provide any support for this repository. If you want to use it, you are on your own.

Firefox occasionally changes its codebase, which may break some of the configurations on newer versions of Firefox. I try to keep this repository updated, but I cannot guarantee that everything will work as expected. To deal with it yourself, refer to the Customizing Firefox section.

For other experimental features, check out the other branches of this repository.

Tip

Disable Telemetry and Data Collection: Ensure that all telemetry and data collection features are turned off in Firefox. You can use my user.js as a reference, and explore other user.js files and hardened Firefox configurations for additional security.

Cookie Management: With cookie isolation enabled, clearing cookies may be less effective. Instead, consider using temporary containers for better privacy.

Customizing Firefox: For detailed guidance on customizing Firefox to suit your needs, refer to the Customizing Firefox section.

JPEG XL (JXL): Firefox 128 now supports JPEG XL images. You can use the JPEG XL format for images to save bandwidth and improve loading times. It is available as image.jxl.enabled in about:config preference. You can enable it by setting it to true. Note that it is currently an experimental feature in Firefox 128+.

Features

• Smooth scrolling
• Animations
• Sidebar (Sidebery) with auto-hide mechanism
• Hovercards
• Scrollable through tabs
• Search bar for tabs in the sidebar
• Custom toolbar button icons
• Custom (bouncing) loading indicator animation
• Only icons in extensions menu
• Icons in main menu items
• Round UI items
• Dark UI in pages (e.g., addons.mozilla.org)
• Custom centered status panel at the top with animations
• Compact about:config list
• Compact items and menus (e.g., context menu)
• Various sidebar (Sidebery, Tree Style Tab) tweaks, including auto-hide
• Animations in tabs that's playing audio
• Consistent and matching colors across various elements and the UI
• Glow and scale effect on hover on toolbar buttons
• Findbar as floating box at the top
• Hidden horizontal tab bar
• Bottom main toolbar and search/url bar
• Hidden bookmarks toolbar visible on hover
• Custom colors on various items
• Centered text in the url bar
• Colored overlay on the url bar based on the type of connection
• RGB animation on the url bar address
• Global font family and size
• Other various fixes and tweaks
• Custom addons configuration
• Various Context menu tweaks (e.g no separators, compact, custom colors & icons, rounded borders)
• Userscripts
• Userstyles
• Custom theme
• Icons in menus (appmenu, context menu, main menu, etc.)
• Various performance and privacy tweaks
• JPEG XL (JXL) enabled by default

Screenshots and GIFs

File Locations

Both user.js and chrome files should be placed in the following locations depending on your operating system:

OS	Location
Linux	~/.mozilla/firefox/<profile_ID>.default/
Windows	%APPDATA%\Mozilla\Firefox\Profiles\<profile_ID>.default/
macOS	~/Library/Application Support/Firefox/Profiles/<profile_ID>.default/

Replace <profile_ID> with your Firefox profile ID.

For addons and userscripts configuration, you can find them in the respective directories.

Finding Your Default Profile

• Linux: You can find your default profile in ~/.mozilla/firefox/profiles.ini OR go to about:support in Firefox, you'll see your default profile directory in the Profile Directory section. Click on Open Directory.

• Windows: Your default profile can be found at %APPDATA%\Mozilla\Firefox\Profiles\. Alternatively, navigate to about:support in Firefox, and click on Open Folder next to the Profile Directory section.

• macOS: Locate your default profile in ~/Library/Application Support/Firefox/Profiles/. Or, go to about:support in Firefox, and click on Show in Finder next to the Profile Directory section.

Enabling userChrome.css and userContent.css

Enable userChrome.css and userContent.css support in Firefox:

1. Go to about:config and click the "Accept the Risk and Continue" button.
2. In the search box, type toolkit.legacyUserProfileCustomizations.stylesheets.
3. Double-click the toolkit.legacyUserProfileCustomizations.stylesheets entry to set its value to true.
4. Restart Firefox.

Additional Tweaks

Toolbar

Go to Open application menu > More tools > Customize toolbar... and make the following changes:

Set Density to Normal and uncheck Title Bar.

To disable bookmarks toolbar:

Customizing Firefox

If you're planning to make multiple and extensive alterations to your UI, learning how to use the Browser Toolbox is essential. It allows you to create modifications to the UI and fix those modifications if a newer version of the Firefox codebase causes issues.

While the Browser Toolbox isn't particularly user-friendly to set up or use initially, perseverance will pay off as it is key to inspecting Firefox's UI. Check out the r/firefoxcss wiki and search the subreddit for specific posts.

Investigate how to use Mozilla's source code indexing tool SearchFox as well.

Most of your "How to" questions can be answered by the Browser Toolbox and SearchFox, though it takes some time to understand them both from scratch.

As an alternative to using the Browser Toolbox and SearchFox, you can explore the wealth of information in subreddits like r/FirefoxCSS, r/firefox, and r/unixporn. Finding the precisely relevant information often requires diligent searching with a variety of keywords. A useful trick is to search with a section of CSS userstyle, a selector, or a rule related to the UI element you want to modify. You can also look on GitHub, GitLab, and other code hosting sites, or simply use your favorite search engine. There are various articles and blogs online as well. Discord servers like unixporn can be helpful too.

Look for specific topics on GitHub: userchrome, firefox-css, firefox-tweaks, userchrome-styles, userchromecss.

More handy resources: userchrome.org, FirefoxCSS Store, Mozilla Bugzilla, The other guide to CSS hacking.

Live Debug and Update userChrome.css

1. Set devtools.debugger.remote-enabled to true in about:config.
2. Set devtools.chrome.enabled to true in about:config.
3. Open remote debugger using Ctrl+Alt+Shift+I.
4. Allow the incoming connection.
5. Select Style Editor tab, then open userChrome.css.
6. Edit and save the file for it to take effect (hot reload).

Theme

The theme I'm currently using: RosyBrown Dark by Me

Addons

You can find a list of addons I use here.

Userscripts

Stylus Styles

Ublock Origin

Enabled all filters except for the regional ones. Added some custom filters:

Notable Mentions

• schizofox - Hardened Firefox flake for the delusional and the schizophrenics. You might find some interesting stuff there.
• Betterfox - Firefox user.js for speed, privacy, and security. Your favorite browser, but better.
• FirefoxCSS-Store - A collection site of Firefox userchrome themes.
• r/FirefoxCSS - A subreddit dedicated to Firefox customization.
• SearchFox - A source code indexing tool for Mozilla Firefox. It indexes C++, Rust, and JavaScript code.
• ArkenFox GUI - Site to help you explore the information from the arkenfox user.js
• fx-autoconfig - A toolkit to load arbitrary javascript files to be run in Firefox browser context. Relies on autoconfig functionality available in Firefox.