#  | Camoufox

> Built for AI agents 🤖

- [Introduction](https://camoufox.com/index.md): Introduction
- [Stealth Overview](https://camoufox.com/stealth.md): There has been a year gap in maintenance due to a personal situation. Camoufox has gone down in performance due to the base Firefox version and newly discovered fingerprint inconsistencies (I explain that in my writeup here).
- [Features List](https://camoufox.com/features.md): Below is a complete list of patches and features implemented in Camoufox.
- [Python Interface](https://camoufox.com/python/index.md): Camoufox's Python library wraps around Playwright's API to help automatically generate & inject unique device characteristics into Camoufox such as the OS, device info, navigator, fonts, headers, screen/viewport size, addons, etc.
- [Fingerprint Injection](https://camoufox.com/fingerprint/index.md): In Camoufox, data is intercepted at the C++ implementation level, making the changes undetectable through JavaScript inspection.
- [Development](https://camoufox.com/development/index.md): The following content is intended for those interested in building & debugging Camoufox.
- [Community Projects](https://camoufox.com/community.md): Note: These projects are independently maintained and are not official Camoufox releases. Review each project before using it in production.
- [Liability Disclaimer](https://camoufox.com/legal.md): No responsibility is accepted for the use of this software. This software is intended for ethical and research purposes only. Users should use this software at their own risk.
- [About Me](https://camoufox.com/about.md): I'm a 20 year old security researcher and student at the University of Texas at Austin, currently on medical leave.

## Python Interface

- [Installation](https://camoufox.com/python/installation.md): First, install the camoufox package:
- [Usage](https://camoufox.com/python/usage.md): Camoufox is fully compatible with your existing Playwright code. You only have to change your browser initialization:
- [GeoIP & Proxy Support](https://camoufox.com/python/geoip.md): By passing geoip=True, or passing in a target IP address, Camoufox will automatically use the target IP's longitude, latitude, timezone, country, locale, & spoof the WebRTC IP address.
- [Main World Execution](https://camoufox.com/python/main-world-eval.md): By default, all JavaScript execution is ran in an isolated scope, invisible to the page.
- [Remote Server](https://camoufox.com/python/remote-server.md): Warning! This feature is experimental. It uses a hacky workaround to gain access to undocumented Playwright methods.
- [Virtual Display](https://camoufox.com/python/virtual-display.md): While Camoufox includes patches to prevent headless detection, running in headless mode may still be detectable in the future. It's recommended to use a virtual display buffer to run Camoufox headlessly.
- [BrowserForge Integration](https://camoufox.com/python/browserforge.md): Camoufox is compatible with BrowserForge fingerprints.
- [Passing Config](https://camoufox.com/python/config.md): If needed, Camoufox config data can be overridden/passed as a dictionary to the config parameter. This can be used to enable features that have not yet been implemented into the Python library.

## Fingerprint Injection

- [Navigator](https://camoufox.com/fingerprint/navigator.md): Navigator properties can be fully spoofed to other Firefox fingerprints, and it is completely safe!
- [Cursor Movement](https://camoufox.com/fingerprint/cursor-movement.md): Camoufox has built-in support for human-like cursor movement. The natural motion algorithm was originally from riflosnake's HumanCursor, but has been rewritten in C++ and modified for more distance-aware trajectories.
- [Fonts](https://camoufox.com/fingerprint/fonts.md): Fonts can be passed to be used in Camoufox through the fonts config property.
- [Screen](https://camoufox.com/fingerprint/screen.md): Property
- [Window](https://camoufox.com/fingerprint/window.md): Property
- [Document](https://camoufox.com/fingerprint/document.md): Spoof the size of the HTML body element.
- [WebGL](https://camoufox.com/fingerprint/webgl.md): As more users visit this site and opt into helping Camoufox's WebGL research, I will have a more solid profile of each GPU's parameters, supported extensions, context attributes, & shader precision formats.
- [Geolocation & Intl](https://camoufox.com/fingerprint/geolocation.md): Property
- [HTTP Headers](https://camoufox.com/fingerprint/headers.md): Property
- [WebRTC IP](https://camoufox.com/fingerprint/webrtc.md): Camoufox implements WebRTC IP spoofing at the protocol level by modifying ICE candidates and SDP before they're sent.
- [Media & Audio](https://camoufox.com/fingerprint/media-audio.md): Spoof the amount of microphones, webcams, and speakers avaliable.
- [Voices](https://camoufox.com/fingerprint/voices.md): Spoof the voices used in the browser's Web Speech API.
- [Addons](https://camoufox.com/fingerprint/addons.md): In the Camoufox Python library, addons can be loaded with the addons parameter.
- [Miscellaneous](https://camoufox.com/fingerprint/miscellaneous.md): Property

## Development

- [Build System](https://camoufox.com/development/overview.md): Here is a diagram of the build system, and its associated make commands:
- [Building in CLI](https://camoufox.com/development/buildcli.md): Camoufox's build system is designed to be used in Linux. WSL will not work!
- [Building in Docker](https://camoufox.com/development/docker.md): To build Camoufox on a non-Linux system you can use Docker.
- [Development Tools](https://camoufox.com/development/tools.md): This repo comes with a developer UI under scripts/developer.py:
- [Leak Debugging](https://camoufox.com/development/workflow.md): This is a flow chart demonstrating my process for determining leaks without deobfuscating WAF Javascript. The method incrementally reintroduces Camoufox's features into Firefox's source code until the testing site flags.