Camoufox SOP

Appearance

Install ​

Requirements ​

  • Python 3.x (no minimum version documented; 3.9+ recommended for async support)
  • pip

Step 1: Install the Python package ​

bash
pip install -U camoufox[geoip]

The [geoip] extra is optional but strongly recommended if you use proxies. It enables automatic locale and timezone matching to the proxy IP address, which significantly improves fingerprint consistency.

To install without GeoIP support:

bash
pip install -U camoufox

Step 2: Download the browser binary ​

After the Python package is installed, download the modified Firefox binary:

bash
camoufox fetch

Alternatively:

bash
python -m camoufox fetch

This downloads the patched Camoufox browser binary for your platform. You must run this before first use.

To remove the downloaded binary later:

bash
camoufox remove

Linux: Firefox dependency note ​

On Linux you may need to install Firefox's system dependencies before the binary will launch. Use your package manager:

bash
# Debian/Ubuntu
sudo apt install -y libgtk-3-0 libx11-xcb1 libdbus-glib-1-2

# Arch Linux
sudo pacman -S gtk3 libx11 dbus-glib

Alpha / hardware-spoofing variant ​

A separate alpha package with hardware-level spoofing is available:

bash
pip install cloverlabs-camoufox

This is more experimental than the main package. Only use it if you specifically need hardware fingerprint spoofing and accept a higher breakage risk.