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.
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.
-
Headless & Incognito Evasion: Seamlessly bypasses detection in both headless and incognito modes.
-
Proxy Authentication: Supports embedding credentials in proxy URLs (e.g.,
http://user:pass@host:port,socks5://user:pass@host:port). -
Custom Flags for Cookies, Bookmarks & Title: Use startup flags (
--bot-cookies,--bot-bookmarks,--bot-title) for session restoration and UI enhancements. -
Fingerprint Noise & Spoof Control: Unified real/noise toggles and noise injection for Canvas, WebGL, audio, text metrics, and headless GPU simulation.
-
On-Demand Geo & Language Detection: Automatically sets timezone, geolocation, and browser languages based on proxy IP.
-
WebRTC Leak Protection: Full IPv4/IPv6 SDP refactor and candidate spoofing to prevent local IP exposure.
-
Chrome Behavior Emulation: Fully emulate Chrome, including Google
X-Browser-*headers, Widevine CDM, and other Chrome-specific features. -
Comprehensive Fingerprint Spoofing:
Category Details Browser Version, userAgentData, userAgent OS Windows, macOS, Ubuntu, Android emulation; Fonts (UI/System); Colors Navigator Languages, Plugins, Permissions, Battery, Keyboard Network Proxy auth, WebRTC SDP spoofing, Google headers Graphics Canvas noise, WebGL/WebGL2, GPUAdapter, GPUDevice Hardware Screen resolution, devicePixelRatio, CPU architecture Media MediaDevices, MimeTypes, AudioContext Other Emoji, Unicode, matchMedia control, client rects, bookmarks
-
Download Installer Get the BotBrowser installer for your OS from the Releases page.
-
Windows
- Extract the downloaded
.7zarchive. - Run
chrome.exefrom the extracted folder. - If you encounter
STATUS_ACCESS_VIOLATION, launch with --no-sandbox.
- macOS
- Open the downloaded
.dmgfile. - Drag
Chromium.appinto your Applications folder or any desired location. - If you see the error:
Run:
"Chromium" is damaged and can't be openedxattr -rd com.apple.quarantine /Applications/Chromium.app
- Ubuntu
- Install via
dpkg:sudo dpkg -i botbrowser_<version>_amd64.deb
- If dependencies are missing, run:
sudo apt-get install -f
📢 In BotBrowser, everything starts with a profile. Your stealth, reliability, and success depend on it.
-
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\\chrome137_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/chrome137_win11_x64.enc"Ubuntu
chromium-browser \
--no-sandbox \
--user-data-dir="$(mktemp -d)" \
--bot-profile="/path/to/chrome137_win11_x64.enc"Use
--user-data-dirwith a unique temporary folder to avoid conflicts with any running Chromium instances. It ensures BotBrowser launches cleanly without interfering with your normal browser profiles.
Use--proxy-server,--proxy-username,--proxy-passwordto connect to a proxy server, we support http, https, socks5 protocol.
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 or relative path to the bot profile
'--proxy-server="socks5://127.0.0.1:8989"',
'--proxy-username=""',
'--proxy-password=""',
],
});
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)
Streamline your automation with BotBrowserConsole, a free and open-source GUI tool designed to:
- Select your profile and start browsing without code
- Easily launch multiple browser instances
- Seamlessly manage different environments
- Efficiently handle multiple accounts
For a complete Docker setup and usage guide, please see docker/README.md.
| Issue | Solution |
|---|---|
| "Chromium" is damaged (macOS) | Run xattr -rd com.apple.quarantine /Applications/Chromium.app |
| STATUS_ACCESS_VIOLATION (Windows) | 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 |
Use our detailed test scripts to explore real-world use cases and implementation examples: Tests.
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 | Antibot Services | Test Results |
|---|---|---|
| Nike | F5 Shape Security | ✅ Success |
| Generic Antibot | ✅ Success |
|
| TikTok | TiktokVM | ✅ Success |
| Walmart | PerimeterX | ✅ Success |
| Temu | F5 Shape Security | ✅ Success |
| Generic Antibot | ✅ Success | |
| TicketMaster | PerimeterX, FingerprintJS, reCAPTCHA | ✅ Success |
| Shein | F5 Shape Security, FingerprintJS, Forter | ✅ Success |
| FunCaptcha, reCAPTCHA | ✅ Success | |
| Bet365 | Generic Antibot | ✅ Success |
...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.
| [email protected] | |
|---|---|
| 📱 Telegram | middle_student |
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.
