🤖 BotBrowser

The Ultimate Solution for Undetectable Automated Browsing 🚀

---

What is BotBrowser?

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.

Simplified Management

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

---

🚀 Core Features

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.

🛡️ Advanced Capabilities

• 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:

Category	Details
Browser	Version, userAgentData, userAgent
OS	Windows, macOS, Ubuntu, Android simulation
Navigator	Languages, Plugins, Permissions, Battery, Keyboard
Graphics	WebGL, WebGL2, GPUAdapter, GPUDevice
Hardware	Screen, CPU, System Fonts, System Colors
Media	MediaDevices, MimeTypes, AudioContext
Other	Emoji, Unicode, matchMedia control

---

🚀 Getting Started

Download & Installation

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

2. 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

3. Windows

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

4. Ubuntu

• Install via dpkg:

  sudo dpkg -i botbrowser_<version>_amd64.deb

• If dependencies are missing, run:

  sudo apt-get install -f

Profiles Configuration

• 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.

• Usage Tips:

  • Ensure your profile file is readable (check permissions).
  • For more configuration options, see the profile-configs guide.

Quick Start Examples

1. CLI

Launch BotBrowser with a profile:

chromium --bot-profile="/absolute/path/to/chrome135_win11_x64.enc"

2. Playwright / Puppeteer Demos

const browser = await chromium.launch({
  headless: true,
  executablePath: BOTBROWSER_EXEC_PATH, // Absolute path to the BotBrowser executable
  args: [`--bot-profile=${BOT_PROFILE_PATH}`], // Absolute 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/");

3. BotBrowserConsole (GUI)

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

🐞 Debugging & FAQs

Issue	Solution
"Chromium" is damaged…	Run xattr -rd com.apple.quarantine /Applications/Chromium.app
STATUS_ACCESS_VIOLATION	Add --no-sandbox flag when launching
Profile file permission errors	Ensure .enc file has read permissions (chmod 644)
BotBrowser won’t start or crashes	Check that your OS and Chromium version match the build; update BotBrowser to the latest release

💡 Tips

• Always use absolute paths for both the executable and the profile.
• Keep BotBrowser updated by re-downloading after each release.
• If you customize profiles, back up the original encrypted files.
• For advanced users, combine multiple flags (e.g., --no-sandbox, --disable-gpu) to improve stability.

---

🎯 Proven Effectiveness

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.

Service & Scripts	Test Results
Cloudflare	▶️ Turnstile, ▶️ Challenge, ▶️ TaxSlayer
Akamai	▶️ PlayStation, ▶️ WizzAir, ▶️ StubHub
Kasada	▶️ Kick, ▶️ PlayStation, ▶️ Twitch, ▶️ WizzAir
F5 Shape	▶️ Southwest
reCAPTCHA	▶️ Test Video
PerimeterX	▶️ TextNow, ▶️ Grubhub
Imperva (Incapsula)	▶️ CopaAir
DataDome	▶️ ShutterStock, ▶️ SeatGeek, ▶️ Hermes
hCaptcha	▶️ EpicGames, ▶️ Discord, ▶️ Steam, ▶️ RiotGames
FunCaptcha	▶️ Blizzard, ▶️ Roblox, ▶️ Hotmail
Accertify	▶️ Grubhub
Forter	▶️ Grubhub
Adscore	▶️ Test Video
ThreatMetrix	🚧 Coming Soon
ProtectedMedia	🚧 Coming Soon
Fake Vision	▶️ FakeVision
FingerprintJS	▶️ BotDetection
CreepJS	▶️ Test Video, ▶️ Android Profile
BrowserScan	▶️ Test Video
Pixelscan	▶️ Test Video, ▶️ Android Profile
iphey	▶️ Test Video, ▶️ Android Profile
device&browserinfo	▶️ Test Video
brotector	▶️ Test Video

Service & Scripts	Anti-bot Services	Test Results
Nike	F5 Shape Security	✅ Success ▶️ Checkout Video
TikTok	Generic Antibot	✅ Success
Walmart	PerimeterX	✅ Success ▶️ Test Video
Temu	F5 Shape Security	✅ Success ▶️ Test Video
LinkedIn	Generic Antibot	✅ Success
TicketMaster	PerimeterX, FingerprintJS, reCAPTCHA	✅ Success ▶️ Checkout Video
Shein	F5 Shape Security, FingerprintJS, Forter	✅ Success
Facebook	FunCaptcha	✅ Success
Bet365	Generic Antibot	✅ Success

...and many more

---

📚 Additional Resources

Profile Generation

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.

📧 Email	[email protected]
📱 Telegram	middle_student

Building from Source

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

---

⚠️ DISCLAIMER

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.