CLEANFOX Firefox Config

CLEANFOX is a Firefox user.js configuration built on top of Betterfox. It keeps the Betterfox performance and privacy baseline, relaxes a few defaults for everyday browsing, and adds a small set of personal UI preferences.

Table of Contents

• Install
• Update
• Sync With Betterfox
• Betterfox Differences
• Optional Preferences
• Recommended Add-ons
• Resources
• Credits

Install

1. Install Firefox, if needed.
2. Download user.js.
3. Open Firefox and go to about:profiles.
4. Find the profile you want to use.
5. Click Open Folder under Root Directory.
6. Place user.js in that folder.
7. Restart Firefox.

You can also download the full repository as a ZIP archive.

Update

Replace the existing profile user.js with the latest version from this repository, then restart Firefox.

Sync With Betterfox

user.js is generated from upstream Betterfox by build.py. The script fetches Betterfox, applies the CLEANFOX changes, writes user.js, and stores the upstream snapshot in upstream/betterfox.user.js.

A monthly GitHub Action runs the sync automatically on the first day of each month.

Betterfox Differences

CLEANFOX keeps Betterfox as the base config, then applies these changes.

Changed Defaults

Preference	Betterfox	CLEANFOX	Reason
browser.contentblocking.category	strict	standard	Avoids breakage with some logins, embeds, and comment widgets.
browser.cache.disk.enable	false	true	Keeps disk cache for faster repeat visits and lower bandwidth use.
browser.search.suggest.enabled	false	true	Keeps address-bar search suggestions and autocomplete.
browser.download.manager.addToRecentDocs	false	removed	Allows downloads to appear in the OS recent-files list.
browser.ai.* / browser.ml.*	disabled	removed	Leaves Firefox AI features at their browser defaults.

Added Preferences

Preference	Description
ui.key.menuAccessKeyFocuses	Disables the menu opening when pressing Alt.
browser.tabs.warnOnClose	Disables the confirmation prompt when closing a window with multiple tabs.
browser.urlbar.openViewOnFocus	Disables the address bar pop-out on focus.
browser.tabs.hoverPreview.enabled	Disables tab previews on hover.
layout.word_select.eat_space_to_next_word	Prevents double-click word selection from including the trailing space.

Optional Preferences

The bottom of user.js includes commented preferences for stricter behavior. Uncomment only the options you want.

Available optional blocks:

• Disable Firefox AI features.
• Stop adding downloads to the OS recent-files list.
• Disable DRM content.
• Disable Firefox Sync-related features.
• Disable OS geolocation service integration.

Recommended Add-ons

• uBlock Origin - ad blocker. Optional: recommended filters.
• Enhancer for YouTube - extra YouTube controls and features.
• Privacy Badger - tracker blocking based on observed behavior.
• Sessionic - session save, manage, and restore tools.
• Duplicate Tab Shortcut - Alt + Shift + D shortcut for duplicating the current tab.

Resources

• Personal Data Leak Check
• Firefox Hardening Guide
• ArchWiki: Firefox Privacy Configuration

Credits

• Betterfox for the base Firefox configuration.

License

Released under the MIT License.