Identical fingerprints on any OS • Cross-platform compatibility • Validated against 31+ detection systems for research benchmarking
BotBrowser delivers identical browser fingerprints across all platforms. Run the same profile on Windows, macOS, or Linux and you'll see the exact same fingerprint every time.
Designed for automation testing, cross-platform compatibility validation, and maintaining consistent browser environments in authorized research and defensive benchmarking settings. Review the project Legal Disclaimer and Responsible Use Guidelines before using the software.
What makes BotBrowser different: Cross-platform browser with unified fingerprint technology that keeps fingerprints identical 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 |
| Network Stack Parity – Browser-level proxies keep geo signals consistent | Full-Proxy QUIC/STUN – Chromium-level UDP associate keeps QUIC/STUN proxied; ICE presets only needed when UDP is unavailable (ENT Tier3 feature, see Network Fingerprint Control) |
- Single profile, every host OS: identical UA, screen metrics, touch surfaces, fonts, and device APIs on Windows/macOS/Linux + Android emulation.
- Built-in automation handles touch simulation, device metrics, and locale/timezone detection from the proxy IP while still allowing CLI overrides when you truly need them.
- Quick demos:
▶️ CreepJS Android •▶️ Iphey •▶️ Pixelscan
Step 1: Download
- Latest release for your OS
- Demo profile (any
.encfile)
Step 2: Launch (
- Windows example:
chrome.exe --no-sandbox --bot-profile="C:\absolute\path\to\profile.enc" --user-data-dir="%TEMP%\botprofile_%RANDOM%"
- macOS/Linux commands follow the same pattern; see INSTALLATION.md for full instructions.
Step 3: Verify
- Visit CreepJS or your preferred test harness to confirm identical fingerprints.
- Timezone/locale/language auto-derive from your proxy/IP; override via CLI only when needed.
📖 Complete Installation Guide →
const browser = await chromium.launch({
headless: true,
executablePath: BOTBROWSER_EXEC_PATH,
args: ['--no-sandbox', `--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 socks5h://is supported when you need hostnames resolved by the proxy
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 multi-layer fingerprint consistency, network-stack control, and automation-hardening.
- 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: 30+ 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; runtime timing scaling (ENT Tier1) and deterministic noise seeds (ENT Tier2)
- Focus & Session Control: Always-active tab emulation, configurable WebRTC ICE servers, and expanded media decoder reporting for authentic runtime signals
- Network & Proxy Enhancements: Per-context proxies with auto geo detection; UDP-over-SOCKS5 tunnel for QUIC/STUN in ENT Tier3; ICE presets optional when UDP is available
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 |
| UA Congruence | Brand + full-version alignment | CLI_FLAGS#Profile Configuration Override Flags |
| 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 |
Fingerprint Consistency Matrix: Cross‑Platform Coverage
| 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
⚠️ 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.
Prefer a GUI launcher? See console/README.md for BotBrowserConsole usage, multi-instance management, and profile selection.
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.
- 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 → - 31+ detection 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 | 30+ CLI flags, noise injection, GPU micro-benchmarks |
| Validation Results | Research data | 31+ detection 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 |
| BotCanvasLab | Canvas forensics tool | Canvas 2D recording with JSONL viewer (deterministic replay under development) |
| 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 |
|---|---|---|
| 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 |
- Review the detailed Responsible Use Guidelines and Legal Disclaimer before requesting binaries or premium profiles.
- Maintain written authorization for every environment you test, and record the synthetic data sets you rely on.
- Contact the maintainers at botbrowser@bk.ru if you observe suspicious activity or need to report an abuse incident.
📋 Legal Disclaimer & Terms of Use • Responsible Use Guidelines. BotBrowser is for authorized fingerprint-consistency testing and research only.
