explaingit

browserworks/waterfox

5,781JavaScriptAudience · generalComplexity · 4/5LicenseSetup · hard

TLDR

A privacy-focused web browser forked from Firefox that removes built-in telemetry and usage tracking while keeping full compatibility with Firefox extensions and your existing bookmarks.

Mindmap

mindmap
  root((Waterfox))
    What it does
      Firefox fork browser
      No telemetry collected
      Full extension support
    Privacy Features
      Tracking removed
      Usage data stripped
      Minimum data only
    Compatibility
      Modern WebExtensions
      Legacy extensions
      Windows macOS Linux Android
    Development
      Firefox codebase base
      MPL 2.0 license
      Community contributions
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Switch from Firefox to a browser that collects no telemetry or usage data by default.

USE CASE 2

Use older Firefox add-ons that no longer run in current Firefox versions.

USE CASE 3

Build and customize your own browser based on the Firefox codebase with Waterfox as the starting point.

USE CASE 4

Study how a large open-source browser project is structured and maintained as a community fork.

Tech stack

JavaScriptC++Mozilla codebase

Getting it running

Difficulty · hard Time to first run · 1day+

Building from source requires following Firefox's full build toolchain, pre-built installers from the Waterfox website are available if you just want to use the browser.

Source code is available under the Mozilla Public License 2.0, you can use and modify it but must share changes to the same files under the same license.

In plain English

Waterfox is a web browser built on the same open-source foundation as Firefox. The project describes itself as a drop-in replacement, meaning you can switch from Firefox without losing access to your existing extensions or bookmarks. The primary motivation for the fork is privacy: Waterfox strips out the telemetry and usage tracking that Firefox includes by default, collecting only the data strictly needed to keep the browser operational. Beyond privacy, the project targets performance improvements on modern hardware and broader customization options, though the README does not go into specific technical changes relative to stock Firefox. The browser supports both the current WebExtensions format used by modern Firefox extensions and older classic extension formats, which matters for users who rely on add-ons that no longer run in standard Firefox. Waterfox runs on Windows, macOS, Linux, and Android. The source code is publicly available and the project welcomes outside contributions. Building from source requires following a separate build guide included in the repository. Because Waterfox inherits the Firefox codebase structure, the README points new contributors to Firefox's own documentation for understanding the directory layout and build tooling. There is no separate developer wiki, the upstream Firefox docs serve that role. Community channels include a subreddit and the official Waterfox website. The core development team works UK business hours, Monday through Friday, excluding bank holidays, so response times on issues and pull requests reflect that schedule. The license is the Mozilla Public License 2.0, the same license that governs Firefox. Pre-built installers for all supported platforms are available directly from the Waterfox website, so building from source is only necessary if you want to modify the code.

Copy-paste prompts

Prompt 1
Walk me through how to build Waterfox from source on Ubuntu, including all the required system dependencies and the build command sequence.
Prompt 2
How does Waterfox differ from standard Firefox at the configuration level, which telemetry and tracking preferences are disabled and where are they set?
Prompt 3
Show me how to package a classic Firefox extension that no longer works in modern Firefox so it runs in Waterfox instead.
Prompt 4
What is the Mozilla Public License 2.0 and how does it affect what I can do if I fork Waterfox to build my own browser?
Open on GitHub → Explain another repo

← browserworks on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.