Identical fingerprints on any OS • Cross-platform compatibility • Works with 29+ detection systems
BotBrowser delivers identical browser fingerprints across all platforms. Run the same profile on Windows, macOS, or Linux — get the exact same fingerprint every time.
Designed for automation testing, cross-platform compatibility validation, and maintaining consistent browser environments.
What makes BotBrowser different: Cross-platform browser with unified fingerprint technology — identical fingerprints everywhere
| Core Advantages | Technical Excellence |
|---|---|
| High-fidelity Profile Simulation - Synthetic/aggregated profiles for realistic, policy-compliant testing | Latest Chromium Base - Always synced to newest stable Chrome for zero fingerprint drift |
| Zero-Config Intelligence - Auto-detects timezone/locale/language from IP | Advanced Programmatic Control - Playwright/Puppeteer integration with CDP leak blocking |
Unified fingerprints: Identical browser fingerprints across all platforms (Windows, macOS, Android) ensuring consistency regardless of host system.
Automatic touch simulation, device metrics, and unified fingerprint rendering across platforms.
Desktop → Android Test Results:
▶️ CreepJS Test - Desktop simulation of Android fingerprint▶️ Iphey Test - Complete mobile device simulation▶️ Pixelscan Test - Cross-platform compatibility demonstration
Step 1: Download
- BotBrowser release for your OS
- Demo profile (any
.encfile)
Step 2: Launch (
Windows:
chrome.exe --no-sandbox --bot-profile="C:\\absolute\\path\\to\\chrome139_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="/absolute/path/to/chrome139_win11_x64.enc"Ubuntu:
chromium-browser --no-sandbox --user-data-dir="$(mktemp -d)" --bot-profile="/absolute/path/to/chrome139_win11_x64.enc"Step 3: Test Visit CreepJS to see fingerprint consistency in action!
🌍 Works instantly — timezone and locale auto-detected from your IP
📖 Complete Installation Guide →
const browser = await chromium.launch({
headless: true,
executablePath: BOTBROWSER_EXEC_PATH,
args: [`--bot-profile=${BOT_PROFILE_PATH}`],
'--proxy-server="socks5://usr:pwd@127.0.0.1:8989"', // or: "http://usr:pwd@127.0.0.1:8989"
});
const page = await browser.newPage();
await page.addInitScript(() => { delete window.__playwright__binding__; delete window.__pwInitScripts; });
await page.goto('https://abrahamjuliot.github.io/creepjs/');Notes:
- Use
--user-data-dirwith a unique temporary folder to avoid conflicts with running Chromium instances - Prefer
--proxy-serveror per‑context proxies; auto timezone/locale detection applies in both cases - Avoid framework‑specific proxy/auth options (e.g.,
page.authenticate()), which bypass BotBrowser geo detection
Examples: Playwright • Puppeteer
More options:
- Framework‑less automation:
--bot-script+ CDP (privileged context, earlier hook, fewer artifacts) - Docker: docker/README.md
- Full flags: CLI_FLAGS.md
Professional-grade browser technology through sophisticated multi-layer fingerprint consistency and cross-platform compatibility systems
Coverage Map — Detection Surfaces → Capabilities → Evidence
This map links common detection surfaces to BotBrowser capabilities and the exact docs/tests where they are demonstrated.
| Detection Surface | Capability | Evidence |
|---|---|---|
| navigator.webdriver | Removed/hidden at engine level | ADVANCED_FEATURES#Chrome Behavior Emulation |
| JS Execution Isolation | CDP/WebDriver artifact blocking | ADVANCED_FEATURES#Playwright/Puppeteer Integration |
| Canvas/WebGL/WebGPU/Audio/Text metrics | Deterministic noise + parameter controls and cross‑worker consistency | ADVANCED_FEATURES#Graphics & Rendering Engine |
| Fonts/Text | Built-in fonts + HarfBuzz shaping | ADVANCED_FEATURES#Cross-Platform Font Engine |
| MediaDevices | Profile-based device spoofing | Profile Configs |
| WebRTC | SDP/ICE manipulation, candidate filtering | ADVANCED_FEATURES#WebRTC Leak Protection |
| Proxies/Geo | Per-context proxy + auto timezone/locale | CLI_FLAGS#Enhanced Proxy Configuration |
| UA Congruence | Brand + full-version alignment | CLI_FLAGS#Profile Configuration Override Flags |
| Headless Parity | GPU/WebGPU/media signals stable | ADVANCED_FEATURES#Headless & Incognito Compatibility |
| DNS Leaks | SOCKS5 DNS-through-proxy | ADVANCED_FEATURES#Enhanced Proxy System |
| HTTP Headers | Chrome-like headers, HTTP/2/3 behavior | ADVANCED_FEATURES#Chrome Behavior Emulation |
| TLS Fingerprint | JA3/JARM/ALPN control (Roadmap) | CHANGELOG |
- Multi‑Layer Consistency: Canvas/WebGL/Text metrics with low‑level Skia/HarfBuzz tuning and targeted WebGL/WebGPU controls
- Clean Automation: CDP/WebDriver hardening, Chrome‑like behavior, and framework‑less early hooks via
--bot-script - Configurability: 20+ CLI overrides, per‑context proxies with automatic geo‑detection, and session tools (cookies/bookmarks/title)
- Headless ↔ GUI Parity: Stable GPU/WebGPU/media signals and consistent behavior across browser modes
- Performance Controls: Precise FPS simulation, memory/storage timing, and GPU micro‑benchmarks for realistic profiles
| Category | Sample Capabilities |
|---|---|
| Graphics | Canvas/WebGL rendering, GPU micro-benchmarks, texture hash configuration |
| Network | WebRTC SDP configuration, proxy auth, connection management |
| Platform | Font fallback chains, cross-worker consistency, OS-specific features |
| Performance | FPS simulation, memory timing, animation frame optimization |
📖 Complete Advanced Features Documentation →
📢 BotBrowser combines synthetic/aggregated profiles with flexible configuration for authorized research. Profile consistency and CLI settings enable comparative analysis.
- Profile Foundation: Synthetic/aggregated profiles provide realistic fingerprint data for authorized testing
- CLI Flexibility: Override profile settings at runtime without modifying encrypted files
- Cross-Platform Compatibility: A macOS profile works on Ubuntu; a Windows profile works on macOS; an Android profile can be fully emulated on any OS
- Auto-Configuration: Timezone, locale, and languages automatically detected from IP/proxy
- CLI Flags: See the ⚙️ CLI flags reference - Recommended for most users
- Profile Settings: See the 📚 profile-configs guide - Advanced configuration
⚠️ Note: This project must only be used in environments you own or where you have explicit authorization. Use against third-party services without permission is strictly prohibited.
For users who prefer a graphical interface, BotBrowserConsole provides a user-friendly way to manage BotBrowser:
Features:
- Select profiles and start browsing without command line
- Launch multiple browser instances easily
- Manage different environments and accounts
- User-friendly interface
Our compatibility research examines browser fingerprinting techniques across different client configurations to improve web compatibility and understand fingerprint consistency.
⚠️ Research demos in authorized environments. See DISCLAIMER.
Anti-Bot Systems:
| Service | Technology | Results |
|---|---|---|
| Cloudflare | Turnstile, Bot Management | |
| DataDome | ML-based detection | |
| PerimeterX | Behavioral analysis |
Fingerprinting Systems:
| Service | Focus | Results |
|---|---|---|
| CreepJS | Comprehensive fingerprinting | |
| FingerprintJS Pro | Commercial fingerprinting | |
| Pixelscan | Detection suite |
- Windows Profile on macOS: Fingerprint consistency maintained
- Android Emulation on Desktop: Complete mobile API simulation
- Headless vs GUI Mode: Identical fingerprint stability
📖 Complete Validation Results & Research Data → - 25+ anti-bot systems, 15+ fingerprinting tools, statistical analysis
| Document | Description | Content Preview |
|---|---|---|
| Installation Guide | Platform-specific setup | Windows/macOS/Ubuntu guides, Docker deployment, troubleshooting |
| Advanced Features | Technical capabilities | 22+ CLI flags, noise injection, GPU micro-benchmarks |
| Validation Results | Research data | 25+ anti-bot systems, 50,000+ test sessions, statistical analysis |
| CLI Flags Reference | Command-line options | --bot-config-* flags, proxy auth, session management |
| Profile Configuration | Profile customization | Fingerprint control, cross-platform compatibility |
| BotCanvas Lab | Canvas forensics tool | Canvas 2D recording, JSONL event viewer, replay roadmap |
| Examples | Code samples | Playwright, Puppeteer, bot-script automation |
Framework Integration:
- Playwright Examples - TypeScript/Python integration
- Puppeteer Examples - JavaScript automation
- Bot-Script Examples - Framework-less
chrome.debuggerAPI
Profile Management:
- Demo profiles available in profiles/ directory
- Premium profiles: Contact botbrowser@bk.ru
| Contact Method | Best For | Link |
|---|---|---|
| đź“§ Email | Technical questions, source code access | botbrowser@bk.ru |
| 📱 Telegram | Community support, quick questions | @botbrowser_support |
For advanced users who want to build BotBrowser from source:
- Requirements: Linux build environment, Chromium build tools
- Source Access: Available to qualified researchers and institutions
Contact botbrowser@bk.ru for source code access and compilation instructions.
| Issue | Platform | Solution |
|---|---|---|
| STATUS_ACCESS_VIOLATION | Windows | Add --no-sandbox flag when launching |
| "Chromium" is damaged | macOS | Run xattr -rd com.apple.quarantine /Applications/Chromium.app |
| Missing dependencies | Ubuntu | Run sudo apt-get install -f |
| Profile file permission errors | All | Ensure .enc file has read permissions (chmod 644) |
| BotBrowser won't start or crashes | All | Check that your OS and Chromium version match the build; update BotBrowser to the latest release |
📋 Legal Disclaimer & Terms of Use — BotBrowser is for authorized fingerprint-consistency testing and research only.