gitwtfhub

wtf is betterfox?

yokoffing/betterfox — explained in plain English

Analysis updated 2026-06-24

10,400JavaScriptAudience · generalComplexity · 1/5Setup · easy

TL;DR

A ready-made Firefox settings file that improves your browser's privacy, security, and speed in one step, download one file, drop it in your Firefox profile folder, and restart.

Mindmap

mindmap
  root((betterfox))
    Modules
      Securefox
      Peskyfox
      Smoothfox
    Benefits
      Privacy
      Security
      Performance
    Setup
      Download user.js
      Place in Profile Folder
      Restart Firefox
    Audience
      Privacy Users
      Non-technical Users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Harden Firefox privacy settings without spending hours in the settings panel, one file handles it all.

REASON 2

Remove UI clutter and distracting elements from the Firefox browser interface.

REASON 3

Improve Firefox scrolling smoothness and overall browsing performance on slower hardware.

REASON 4

Use as a reference for understanding what each Firefox setting does and why it matters for privacy.

What's in the stack?

JavaScriptFirefox

How it stacks up

yokoffing/betterfoxvickscarlet/liferestartksky521/nodeppt
Stars10,40010,40110,363
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderateeasy
Complexity1/52/52/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min
No license information is mentioned in the explanation.

Wtf does this do

Betterfox is a configuration file for Mozilla Firefox that adjusts a large number of browser settings at once to improve privacy, security, and performance. Firefox stores its internal settings in a file called user.js, and Betterfox is a carefully curated version of that file. Instead of visiting Firefox's settings panel and changing things one by one, you download this file and place it in your Firefox profile folder. The next time Firefox starts, it applies all those settings automatically. The philosophy behind Betterfox is deliberate restraint. Rather than applying every possible privacy or security tweak available (some collections of Firefox settings go very far in locking things down and end up breaking websites), Betterfox aims for what the author calls the minimum effective dose. The idea is to get meaningful privacy and performance improvements while keeping the browser functional for normal daily use. The project is split into a few separate configuration guides. Securefox focuses on data protection. Peskyfox removes clutter and distractions from the browser interface. Smoothfox adjusts scrolling behavior. The main user.js file pulls in the settings the author considers essential from all of these. Several Firefox-based browsers, including Zen, Floorp, Waterfox, and Midori, have incorporated Betterfox into their default configurations. The project notes that these integrations sometimes water down the settings, so using the file directly still gives the best results. Setup requires downloading the user.js file, placing it in the right folder inside your Firefox profile directory, and restarting the browser. No programming knowledge is needed. The project also recommends pairing it with an ad blocker and DNS-level protection for fuller coverage.

Yoink these prompts

Prompt 1
I just added the Betterfox user.js to Firefox and a website is broken. Help me identify which Betterfox setting might be causing the issue and how to override it for just that site.
Prompt 2
Explain the difference between Betterfox's Securefox, Peskyfox, and Smoothfox sections and which browser settings each one changes.
Prompt 3
I want to build my own Firefox user.js based on Betterfox. Show me how to structure the file and which settings to prioritize for maximum privacy without breaking everyday sites.
Prompt 4
What DNS-level protection tool should I pair with Betterfox, and how do I set it up to complement the browser-level privacy settings?

Frequently asked questions

wtf is betterfox?

A ready-made Firefox settings file that improves your browser's privacy, security, and speed in one step, download one file, drop it in your Firefox profile folder, and restart.

What language is betterfox written in?

Mainly JavaScript. The stack also includes JavaScript, Firefox.

What license does betterfox use?

No license information is mentioned in the explanation.

How hard is betterfox to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is betterfox for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.