camoufox/docs/beta-testing-ff146.md

Testing Firefox 146 Beta

This guide explains how to test the experimental Firefox 146 build of Camoufox.

Note: The FF146 build is experimental and may contain bugs. For a stable production version, use branch releases/135.

Build from Source

1. Clone the repository:

git clone --depth 1 https://github.com/daijro/camoufox
cd camoufox

2. Set up the build environment:

make dir
make bootstrap   # only needed once

3. Build for your target platform:

python3 multibuild.py --target <os> --arch <arch>

Parameter	Options
--target	linux, windows, macos
--arch	x86_64, arm64, i686

Build artifacts will appear in the dist/ folder.

Default Install Directories

When using the Python library (camoufox fetch), the default install directory is:

OS	Install Directory
Linux	~/.cache/camoufox/
macOS	~/Library/Caches/camoufox/
Windows	C:\Users\<user>\AppData\Local\camoufox\camoufox\Cache\

Replacing the Binary

To test FF146 with an existing Camoufox installation:

1. Build from source using the instructions above
2. Extract the built zip from dist/
3. Replace the binary at the corresponding path for your OS:

Linux:

cp /path/to/built/camoufox-bin ~/.cache/camoufox/camoufox-bin

macOS:

cp /path/to/built/Camoufox.app ~/Library/Caches/camoufox/Camoufox.app

Windows:

copy C:\path\to\built\camoufox.exe C:\Users\<user>\AppData\Local\camoufox\camoufox\Cache\camoufox.exe