HeitorAugustoLN/betterfox-nix

---

HeitorAugustoLN/betterfox-nix.json

{
  "createdAt": "2024-07-21T18:48:57Z",
  "defaultBranch": "main",
  "description": "Home-manager module to integrate Betterfox user.js in Firefox",
  "fullName": "HeitorAugustoLN/betterfox-nix",
  "homepage": "",
  "language": "Nix",
  "name": "betterfox-nix",
  "pushedAt": "2025-11-24T01:07:02Z",
  "stargazersCount": 49,
  "topics": [
    "betterfox",
    "firefox",
    "home-manager",
    "nix",
    "nix-darwin",
    "nix-flake",
    "nixos"
  ],
  "updatedAt": "2025-11-24T01:07:03Z",
  "url": "https://github.com/HeitorAugustoLN/betterfox-nix"
}

Betterfox-nix

This repository provides a Nix Home Manager module that integrates the Betterfox user.js configurations into Firefox, enhancing privacy and performance.

Table of contents

• [Features]!(#features)
• [Getting started]!(#getting-started)
• [Acknowledgments]!(#acknowledgments)
• [License]!(#license)

Features

• Automatic Integration: Seamlessly apply Betterfox settings to your Firefox profiles using Nix.
• Version Control: Choose the Betterfox version that suits your needs, including the latest main branch or specific releases.
• Cross-platform: Works on any system supported by Nix and Home Manager.

Getting started

To begin using Betterfox-nix, add the module to your Nix configuration and enable it for your preferred browser.

Example Configuration

Below is an example of how to integrate Betterfox with Firefox using this module:

{ inputs, ... }:
{
  imports = [ inputs.betterfox.modules.homeManager.betterfox ]; # or inputs.betterfox.homeModules.betterfox

  # In firefox
  programs.firefox = {
    enable = true;

    betterfox = {
      enable = true;

      profiles.example-profile = {
        # Set this to enable all sections by default
        enableAllSections = true;

        settings = {
          # To enable/disable specific sections
          fastfox.enable = true;

          # To enable/disable specific subsections
          peskyfox = {
            enable = true;
            mozilla-ui.enable = false;
          };

          # To enable/disable specific options
          securefox = {
            enable = true;
            tracking-protection."browser.download.start_downloads_in_tmp_dir".value = false;
          };
        };
      };

      version = "142.0"; # Set version here, defaults to main branch
    };

    profiles.example-profile = {
      name = "Example";
    };
  };
}

Acknowledgments

• @e-tho for the foundational work on betterfox-extractor and betterfox-generator.
• @dwarfmaster for developing the arkenfox home-manager module that inspired this project.

License

This project is licensed under the [MIT License]!(LICENSE).