BotBrowser is a cross-platform stealth browser designed to defeat modern antibot systems. By directly modifying Chromium's C++ source code, BotBrowser eliminates the fingerprint leaks and automation traces left behind by CDP-based solutions, enabling true undetectable browsing and automation.

Streamline your automation with BotBrowserConsole, a free and open-source GUI tool designed to:

• Easily launch multiple browser instances
• Seamlessly manage different environments
• Efficiently handle multiple accounts

Cross-Platform OS Simulation

Use distinct cross-platform profiles to emulate Windows, macOS, Ubuntu, or Android on any host-undetectable even in headless mode.

Latest Chromium Base

Always aligned with the newest stable Chromium release, ensuring cutting‑edge compatibility with today's most advanced antibot defenses.

Unlimited Android Chrome Emulation

Emulate Android devices (metrics, UA, touch & sensors, etc.) flawlessly and undetectably. ▶️ creepjs test, ▶️ iphey test, ▶️ pixelscan test

Advanced Programmatic Control

Harness CDP through Playwright and Puppeteer alongside deep C++ modifications that block CDP leak detection, delivering both powerful automation and rock‑solid stealth.

Success & Performance

Proven 98%+ success against sophisticated antibot measures, powering over 350,000 daily account registrations with exceptional stability and speed under heavy loads.

• Bypass headless and incognito checks: Enables undetectable automation by seamlessly evading detection in both headless and incognito modes.

• Noise injection: Randomizes 2D canvas, WebGL, emoji, fonts, text metrics, and audio fingerprints.

• Simulated OS-specific properties: Adjusts scrollbar width, BarcodeDetector, and system-specific settings for enhanced authenticity.

• Chrome feature masking: Removes Chromium-specific traits, simulating native Chrome with features like ADInterest and CDM for enhanced detection evasion.

• WebRTC leak protection: Prevents exposure of real IPs during WebRTC communication.

• Comprehensive fingerprints spoofing:

1. Download Installer Get the BotBrowser installer for your OS from the Releases page.

2. Windows

• Extract the downloaded .7z archive.
• Run chrome.exe from the extracted folder.
• If you encounter STATUS_ACCESS_VIOLATION, launch with --no-sandbox.

3. macOS

• Open the downloaded .dmg file.
• Drag Chromium.app into your Applications folder or any desired location.
• If you see the error:

  "Chromium" is damaged and can't be opened
  

  Run:

  xattr -rd com.apple.quarantine /Applications/Chromium.app

4. Ubuntu

• Install via dpkg:

  sudo dpkg -i botbrowser_<version>_amd64.deb

• If dependencies are missing, run:

  sudo apt-get install -f

• Demo Profiles: located in the profiles directory of the repository.

• Cross-Platform:

  🔥 A macOS profile works on Ubuntu; a Windows profile works on macOS; an Android profile can be fully emulated on macOS, Windows, and Ubuntu.

• Configuration Options: see the 📚 profile-configs guide.

Windows (CMD)

chrome.exe --no-sandbox --bot-profile="C:\\path\\to\\chrome136_win11_x64.enc" --user-data-dir="%TEMP%\\botprofile_%RANDOM%"

macOS

/Applications/Chromium.app/Contents/MacOS/Chromium \
  --no-sandbox \
  --user-data-dir="$(mktemp -d)" \
  --bot-profile="/path/to/chrome136_win11_x64.enc"

Ubuntu

chromium-browser \
  --no-sandbox \
  --user-data-dir="$(mktemp -d)" \
  --bot-profile="/path/to/chrome136_win11_x64.enc"

Use --user-data-dir with a unique temporary folder to avoid conflicts with any running Chromium instances. It ensures BotBrowser launches cleanly without interfering with your normal browser profiles.

const browser = await chromium.launch({
  headless: true,
  executablePath: BOTBROWSER_EXEC_PATH, // Absolute path to the BotBrowser executable
  args: [`--bot-profile=${BOT_PROFILE_PATH}`], // Absolute or relative path to the bot profile
});

const page = await browser.newPage();

// Remove Playwright's bindings to avoid detection.
await page.addInitScript(() => {
  delete window.__playwright__binding__;
  delete window.__pwInitScripts;
});
await page.goto("https://abrahamjuliot.github.io/creepjs/");

Use the open-source GUI to select your profile and start browsing without code.

Configuration:

• Profile: Place your .enc file in ./profiles/ and update the filename in docker-compose.yml
• Port: Default is 9222, change in docker-compose.yml if needed
• Volumes: Browser data persists in ./user-data-dir/

Quick Start:

# Build and start the container
docker-compose up --build

Connecting to BotBrowser:

1. Chrome DevTools (Browser)

   Open Chrome/Chromium and navigate to: chrome://inspect
   Click "Configure..." and add: localhost:9222
   Your BotBrowser instance will appear under "Remote Target"
   

2. Automation Scripts (WebSocket)

   // Playwright
   const browser = await chromium.connectOverCDT('ws://localhost:9222');
   
   // Puppeteer
   const browser = await puppeteer.connect({
     browserWSEndpoint: 'ws://localhost:9222'
   });

Note: The Docker version runs in headless mode by default. User data and profiles are mounted as volumes for persistence between container restarts.

Use our detailed test scripts to explore real-world use cases and implementation examples: Tests.

⚠️ DISCLAIMER

These test scripts are provided for educational purposes and to demonstrate the capabilities of BotBrowser. They are intended solely for legal use cases that comply with all applicable laws and regulations. Any misuse-such as violating website terms of service or engaging in unlawful activities-is strictly prohibited.

...and many more

We do not provide the private key required to generate new profiles. If you need additional profiles, please contact us directly. We maintain over 300,000 real user browser fingerprints to support your needs.

If you wish to compile your own version of Chromium with our modifications, follow the instructions provided here.

BotBrowser is intended for legitimate use cases that comply with all applicable laws and regulations. Misuse of this tool to violate the terms of service of websites or engage in illegal activities is strictly prohibited.