{"id":34819433,"url":"https://github.com/botswin/botbrowser","last_synced_at":"2026-04-06T02:09:14.708Z","repository":{"id":256438405,"uuid":"854084975","full_name":"botswin/BotBrowser","owner":"botswin","description":"Advanced Privacy Browser Core with Unified Fingerprint Defense: Cloudflare, Akamai, Kasada, Shape, DataDome, PerimeterX, hCaptcha, FunCaptcha, Imperva, reCAPTCHA, ThreatMetrix, Adscore","archived":false,"fork":false,"pushed_at":"2026-03-08T16:55:34.000Z","size":698404,"stargazers_count":2257,"open_issues_count":4,"forks_count":258,"subscribers_count":38,"default_branch":"main","last_synced_at":"2026-03-08T20:44:55.990Z","etag":null,"topics":["akamai","anti-detection","antibot","automation","bot-detection","chromedriver","cloudflare","datadome","incapsula","kasada","perimeterx","puppeteer","scraping","shapesecurity","threatmetrix","web3","webdriver"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/botswin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-09-08T11:24:03.000Z","updated_at":"2026-03-08T16:55:38.000Z","dependencies_parsed_at":"2024-11-15T22:31:04.062Z","dependency_job_id":"d43e0875-dbe0-42f2-8311-0babd8cf9c04","html_url":"https://github.com/botswin/BotBrowser","commit_stats":{"total_commits":27,"total_committers":2,"mean_commits":13.5,"dds":0.03703703703703709,"last_synced_commit":"5d64547f9551ca16d5a41c6bc7a4b652e200a99a"},"previous_names":["middleschoolstudent/botbrowser","botswin/botbrowser"],"tags_count":63,"template":false,"template_full_name":null,"purl":"pkg:github/botswin/BotBrowser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botswin%2FBotBrowser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botswin%2FBotBrowser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botswin%2FBotBrowser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botswin%2FBotBrowser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/botswin","download_url":"https://codeload.github.com/botswin/BotBrowser/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botswin%2FBotBrowser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30283703,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T02:57:19.223Z","status":"ssl_error","status_checked_at":"2026-03-09T02:56:26.373Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["akamai","anti-detection","antibot","automation","bot-detection","chromedriver","cloudflare","datadome","incapsula","kasada","perimeterx","puppeteer","scraping","shapesecurity","threatmetrix","web3","webdriver"],"created_at":"2025-12-25T14:08:40.476Z","updated_at":"2026-03-09T05:04:36.131Z","avatar_url":"https://github.com/botswin.png","language":"TypeScript","readme":"\u003ch1 align=\"center\"\u003e\u003cimg src=\"docs/assets/logo-32.svg\" alt=\"BotBrowser logo\" width=\"32\" height=\"32\" /\u003e BotBrowser\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eAdvanced Privacy Browser Core with Unified Fingerprint Defense 🚀\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n  Identical privacy posture on any OS • Cross-platform \u0026 WebView simulation • Fingerprint protection validated across 31+ tracking scenarios\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/botswin/BotBrowser/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/botswin/BotBrowser?style=flat-square\" alt=\"Latest Release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/botswin/BotBrowser/commits/main/\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/commit-activity/m/botswin/BotBrowser?style=flat-square\" alt=\"Commit Activity\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/botswin/BotBrowser/issues\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/botswin/BotBrowser?style=flat-square\" alt=\"Issues\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/botswin/BotBrowser/fork\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/forks/botswin/BotBrowser?style=flat-square\" alt=\"GitHub Forks\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/botswin/BotBrowser\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/botswin/BotBrowser\" alt=\"GitHub Stars\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"600\" alt=\"BotBrowser GUI - Your Command Center\" src=\"https://github.com/user-attachments/assets/0f003494-ec92-4c3a-b879-b08d3521a0fb\"\u003e\n\u003c/div\u003e\n\n---\n## What Is BotBrowser?\n\nBotBrowser is a privacy-first browser core designed to protect users from browser fingerprinting, a technique recognized as a privacy threat by W3C, major browser vendors, privacy regulators, and academic research ([see references](FINGERPRINT_PRIVACY.md)). It keeps fingerprint signals uniform across every platform, preventing tracking systems from collecting and correlating data to identify users. Run the same profile on Windows, macOS, or Linux and the fingerprint posture stays identical each time.\n\nAll engineering focuses on privacy research, cross-platform tracking-resistance validation, and maintaining protected environments for authorized defensive benchmarking. Review the project [Legal Disclaimer](DISCLAIMER.md) and [Responsible Use Guidelines](RESPONSIBLE_USE.md) before using the software.\n\n---\n\n## Why BotBrowser\n\n\u003e **What makes BotBrowser different:** Cross-platform privacy browser core with unified fingerprint technology that prevents tracking data collection and device linkage.\n\n\u003ctable cellspacing=\"0\" cellpadding=\"8\"\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\"\u003e\u003cstrong\u003eHigh-Fidelity, Always-Current Profiles\u003c/strong\u003e including Android WebView, built on the latest stable Chromium so fingerprints always match current browser behavior and trackers cannot key on stale engines\u003c/td\u003e\n    \u003ctd width=\"50%\"\u003e\u003cstrong\u003eNetwork Stack Parity\u003c/strong\u003e with \u003ca href=\"ADVANCED_FEATURES.md#network-fingerprint-control\"\u003eFull-Proxy QUIC/STUN\u003c/a\u003e (UDP over SOCKS5) delivers Chromium-level tunneling so geo metadata does not leak and privacy labs maintain clean transport parity\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\"\u003e\u003cstrong\u003eAdvanced Programmatic Control\u003c/strong\u003e offers \u003ca href=\"examples/\"\u003ePlaywright/Puppeteer integration\u003c/a\u003e with CDP leak blocking so privacy tooling leaves no telemetry residue\u003c/td\u003e\n    \u003ctd width=\"50%\"\u003e\u003cstrong\u003eDistributed Privacy Consistency\u003c/strong\u003e lets you verify privacy protection across multiple browser instances simultaneously \u003ca href=\"tools/mirror/\"\u003ewith Mirror\u003c/a\u003e, synchronizing input and validating privacy posture in parallel\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\"\u003e\u003cstrong\u003ePer-Context Fingerprint\u003c/strong\u003e enables \u003ca href=\"PER_CONTEXT_FINGERPRINT.md\"\u003eindependent fingerprint bundles per BrowserContext\u003c/a\u003e without spawning new processes, with millisecond-level switching and reduced memory overhead\u003c/td\u003e\n    \u003ctd width=\"50%\"\u003e\u003cstrong\u003eZero-Overhead Performance\u003c/strong\u003e adds \u003ca href=\"BENCHMARK.md\"\u003eno measurable latency\u003c/a\u003e: Speedometer 3.0 within \u0026lt;1% of stock Chrome, zero fingerprint API overhead across macOS/Linux/Windows, and 29% memory savings at scale with Per-Context Fingerprint\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n### Cross-Platform Fingerprint Protection\n\n- Single profile, every host OS: identical UA, screen metrics, touch surfaces, fonts, and device APIs on Windows, macOS, Linux (ENT Tier1), Android (PRO), and WebView (ENT Tier3) so trackers see the same fingerprint everywhere.\n- Built-in configuration handles touch simulation, device metrics, and locale/timezone detection from the proxy IP while still allowing CLI overrides when privacy experiments require them.\n- Quick demos: [▶️ CreepJS Android](//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-creepjs-creepjs-Android) • [▶️ Iphey](//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-iphey-iphey-Android) • [▶️ Pixelscan](//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-pixelscan-pixelscan-Android)\n\n---\n\n## Getting Started\n\n### Quick Start\n\n**Step 1: Download**\n- [Latest release](https://github.com/botswin/BotBrowser/releases) for your OS\n- [Demo profile](profiles/) (any `.enc` file)\n\n**Step 2: Launch**\n- **GUI:** Use [BotBrowserLauncher](launcher/) for one-click profile selection and multi-instance management\n- **CLI** (use absolute paths):\n  ```cmd\n  chrome.exe --bot-profile=\"C:\\absolute\\path\\to\\profile.enc\" --user-data-dir=\"%TEMP%\\botprofile_%RANDOM%\"\n  ```\n- macOS/Linux commands follow the same pattern; see [INSTALLATION.md](INSTALLATION.md) for full instructions.\n\n**Step 3: Verify**\n- Visit [CreepJS](https://abrahamjuliot.github.io/creepjs/) or your preferred tracking observatory to confirm identical privacy posture.\n- Timezone/locale/language auto-derive from your proxy/IP; override via CLI only when needed.\n\n\n**[Complete Installation Guide →](INSTALLATION.md)**\n\n### Minimal Playwright Example\n\n```javascript\nconst browser = await chromium.launch({\n  headless: true,\n  executablePath: BOTBROWSER_EXEC_PATH,\n  args: [`--bot-profile=${BOT_PROFILE_PATH}`,\n  '--proxy-server=socks5://usr:pwd@127.0.0.1:8989']  // or: http://usr:pwd@127.0.0.1:8989\n});\nconst page = await browser.newPage();\nawait page.addInitScript(() =\u003e { delete window.__playwright__binding__; delete window.__pwInitScripts; });\nawait page.goto('https://abrahamjuliot.github.io/creepjs/');\n```\n\n**Notes:**\n- Use `--user-data-dir` with a unique temporary folder to avoid conflicts with running Chromium instances\n- Prefer `--proxy-server` or [per-context proxies](PER_CONTEXT_FINGERPRINT.md) (ENT Tier1); auto timezone/locale detection applies in both cases\n- Avoid framework-specific proxy/auth options (e.g., `page.authenticate()`), which disable BotBrowser's geo-detection and may leak location information\n\nExamples: [Playwright](examples/playwright/) • [Puppeteer](examples/puppeteer/)\n\n**More options:**\n- Framework-less approach: [`--bot-script`](CLI_FLAGS.md#--bot-script) + [CDP](examples/bot-script/) (privileged context, earlier hook, fewer artifacts)\n- Docker: [docker/README.md](docker/)\n- Full flags: [CLI_FLAGS.md](CLI_FLAGS.md)\n\n## Feature Reference\n\n\u003e Configuration priority: [CLI flags](CLI_FLAGS.md) (highest) \u003e [Profile configs](profiles/PROFILE_CONFIGS.md) \u003e defaults. Timezone, locale, and language auto-derive from your proxy IP.\n\n### Network \u0026 Proxy\n\n| Feature | Reference |\n|---------|-----------|\n| Proxy with embedded credentials (HTTP/SOCKS5/SOCKS5H) | [Proxy Configuration](CLI_FLAGS.md#enhanced-proxy-configuration) |\n| Regex-based proxy routing rules | [--proxy-bypass-rgx](CLI_FLAGS.md#--proxy-bypass-rgx) |\n| Per-context proxy with auto geo-detection | [Per-Context Fingerprint](PER_CONTEXT_FINGERPRINT.md) |\n| Dynamic proxy switching at runtime | [Dynamic Proxy Switching](ADVANCED_FEATURES.md#dynamic-proxy-switching) |\n| UDP over SOCKS5 (QUIC/STUN tunneling) | [UDP over SOCKS5](CLI_FLAGS.md#udp-over-socks5-ent-tier3) |\n| Local DNS solver | [--bot-local-dns](CLI_FLAGS.md#--bot-local-dns-ent-tier1) |\n| Port protection for local services | [--bot-port-protection](CLI_FLAGS.md#--bot-port-protection-pro) |\n| WebRTC leak protection (SDP/ICE control) | [WebRTC Leak Protection](ADVANCED_FEATURES.md#webrtc-leak-protection) |\n\n### Fingerprint \u0026 Rendering\n\n| Feature | Reference |\n|---------|-----------|\n| Canvas / WebGL / WebGPU deterministic noise | [Multi-Layer Noise](ADVANCED_FEATURES.md#multi-layer-fingerprint-noise) |\n| AudioContext noise calibration | [Multi-Layer Noise](ADVANCED_FEATURES.md#multi-layer-fingerprint-noise) |\n| Text metrics \u0026 ClientRects noise | [Multi-Layer Noise](ADVANCED_FEATURES.md#multi-layer-fingerprint-noise) |\n| Deterministic noise seeds (reproducible per-tenant) | [--bot-noise-seed](CLI_FLAGS.md#behavior--protection-toggles) |\n| Performance timing protection (27 browser operations) | [Performance Timing Protection](ADVANCED_FEATURES.md#performance-timing-protection) |\n| Stack depth fingerprint control (main/Worker/WASM) | [Stack Depth Control](ADVANCED_FEATURES.md#stack-depth-control) |\n| Network information privacy (rtt/downlink/effectiveType) | [Network Info Privacy](ADVANCED_FEATURES.md#network-info-privacy) |\n| CPU core scaling protection | [CPU Core Scaling](ADVANCED_FEATURES.md#cpu-core-scaling) |\n| Cross-platform font engine (Win/Mac/Android) | [Font Engine](ADVANCED_FEATURES.md#cross-platform-font-engine) |\n| GPU simulation on headless servers | [Headless Compatibility](ADVANCED_FEATURES.md#headless-incognito-compatibility) |\n\n### Identity \u0026 Platform\n\n| Feature | Reference |\n|---------|-----------|\n| Cross-platform profile portability (Win / Mac / Linux) | [Advanced Features](ADVANCED_FEATURES.md) |\n| Browser brand switching (Chrome/Edge/Brave/Opera) | [Profile Overrides](CLI_FLAGS.md#profile-configuration-override-flags) |\n| Custom User-Agent with full userAgentData control | [Profile Overrides](CLI_FLAGS.md#profile-configuration-override-flags) |\n| Client Hints alignment (DPR, device-memory, UA-CH) | [Browser \u0026 OS](ADVANCED_FEATURES.md#browser-os-fingerprinting) |\n| Android WebView emulation | [Profile Overrides](CLI_FLAGS.md#profile-configuration-override-flags) |\n| Chrome behavior emulation (HTTP/2, HTTP/3, headers) | [Chrome Behavior](ADVANCED_FEATURES.md#chrome-behavior-emulation) |\n\n### Automation \u0026 Scripting\n\n| Feature | Reference |\n|---------|-----------|\n| Playwright / Puppeteer integration | [Examples](examples/) |\n| Framework-less bot-script (chrome.debugger API) | [--bot-script](CLI_FLAGS.md#--bot-script) |\n| Per-context fingerprint (multiple profiles per process) | [Per-Context Fingerprint](PER_CONTEXT_FINGERPRINT.md) |\n| Console message suppression | [Behavior Toggles](CLI_FLAGS.md#behavior--protection-toggles) |\n| Headless / GUI parity | [Headless Compatibility](ADVANCED_FEATURES.md#headless-incognito-compatibility) |\n| Mirror: distributed privacy consistency | [Mirror Documentation](tools/mirror/) |\n| CanvasLab: Canvas 2D / WebGL / WebGL2 recorder | [--bot-canvas-record-file](CLI_FLAGS.md#--bot-canvas-record-file) |\n\n### Session \u0026 Behavior\n\n| Feature | Reference |\n|---------|-----------|\n| Cookie management (inline JSON or file) | [--bot-cookies](CLI_FLAGS.md#--bot-cookies) |\n| Bookmark injection | [--bot-bookmarks](CLI_FLAGS.md#--bot-bookmarks) |\n| Random history injection | [Behavior Toggles](CLI_FLAGS.md#behavior--protection-toggles) |\n| Always-active windows (anti-focus-tracking) | [Active Window](ADVANCED_FEATURES.md#active-window-emulation) |\n| Custom HTTP headers (CLI + CDP) | [--bot-custom-headers](CLI_FLAGS.md#--bot-custom-headers-pro) |\n| Plaintext storage access (cookies, localStorage) | [Storage Access](examples/storage-access/) |\n| Precision FPS simulation | [Behavior Toggles](CLI_FLAGS.md#behavior--protection-toggles) |\n| Timing scale (performance.now compression) | [Behavior Toggles](CLI_FLAGS.md#behavior--protection-toggles) |\n| Window/screen dimension control | [Profile Overrides](CLI_FLAGS.md#profile-configuration-override-flags) |\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eFingerprint Protection Implementation: Privacy Controls → Technical Design → Validation\u003c/strong\u003e\u003c/summary\u003e\n\nThis reference maps privacy protection goals to BotBrowser implementation details and validation evidence.\n\n| Privacy Protection | Implementation | Reference |\n|---|---|---|\n| API standardization | navigator.webdriver standardized across all platforms so trackers cannot use API presence/absence as identification signal | [ADVANCED_FEATURES#Chrome Behavior Emulation](ADVANCED_FEATURES.md#chrome-behavior-emulation) |\n| Execution environment protection | Isolated execution context prevents framework artifacts from exposing privacy leaks | [ADVANCED_FEATURES#Playwright/Puppeteer Integration](ADVANCED_FEATURES.md#playwright-puppeteer-integration) |\n| Graphics rendering consistency | Deterministic noise across Canvas, WebGL, WebGPU, and audio ensures protected fingerprints even in GPU-dependent scenarios | [ADVANCED_FEATURES#Graphics \u0026 Rendering Engine](ADVANCED_FEATURES.md#graphics-rendering-engine) |\n| GPU fingerprint uniformity | Canvas and WebGPU rendering shares deterministic properties so GPU probes like [WebBrowserTools](https://webbrowsertools.com/webgpu-fingerprint/) return authentic results | [CHANGELOG#2025-12-08](CHANGELOG.md#2025-12-08) |\n| Typography consistency | Embedded font engines for Windows, macOS, Linux, and Android ensure text rendering remains identical across platforms | [ADVANCED_FEATURES#Cross-Platform Font Engine](ADVANCED_FEATURES.md#cross-platform-font-engine) |\n| Font availability uniformity | DOM queries return authentic font lists from embedded bundles so host system fonts cannot leak platform identity | [ADVANCED_FEATURES#Cross-Platform Font Engine](ADVANCED_FEATURES.md#cross-platform-font-engine) |\n| Device capabilities | Profile-based device properties maintain protected device claims across all platforms | [Profile Configs](profiles/PROFILE_CONFIGS.md) |\n| Network topology privacy | WebRTC signaling stays protected through SDP and ICE controls preventing network topology leakage | [ADVANCED_FEATURES#WebRTC Leak Protection](ADVANCED_FEATURES.md#webrtc-leak-protection) |\n| User agent coherence | Browser brand and version parity prevents UA string from revealing platform differences | [CLI_FLAGS#Profile Configuration Override Flags](CLI_FLAGS.md#profile-configuration-override-flags) |\n| Header to API parity | Client Hints headers DPR, device-memory, and UA-CH align with JavaScript reported values preventing header based identification | [ADVANCED_FEATURES#Browser \u0026 OS Fingerprinting](ADVANCED_FEATURES.md#browser-os-fingerprinting) |\n| Execution mode parity | GPU, WebGPU, and media signals remain identical whether running headless or in GUI mode | [ADVANCED_FEATURES#Headless \u0026 Incognito Compatibility](ADVANCED_FEATURES.md#headless-incognito-compatibility) |\n| DNS privacy | Use local DNS solver (ENT Tier1) for private resolution that avoids DNS leaks and provider restrictions, or use SOCKS5H to keep DNS within proxy tunnels | [CLI_FLAGS#Enhanced Proxy Configuration](CLI_FLAGS.md#enhanced-proxy-configuration) |\n| Public IP discovery | Customizable IP lookup backend for geo derivation via `--bot-ip-service` (supports comma-separated endpoints; BotBrowser races them and uses the fastest successful response) | [CLI_FLAGS#Enhanced Proxy Configuration](CLI_FLAGS.md#enhanced-proxy-configuration) |\n| Protocol conformance | HTTP/2 and HTTP/3 behavior matches Chrome specifications preventing protocol based differentiation | [ADVANCED_FEATURES#Chrome Behavior Emulation](ADVANCED_FEATURES.md#chrome-behavior-emulation) |\n| TLS fingerprint protection | JA3, JARM, and ALPN parameters optimized for uniform TLS negotiation across platforms | [CHANGELOG](CHANGELOG.md) |\n| DRM capability consistency | Widevine persistent license support with platform-appropriate license negotiation prevents tracking via EME capability fingerprinting | [ADVANCED_FEATURES](ADVANCED_FEATURES.md#complete-fingerprint-control) |\n| Authentication capability uniformity | WebAuthn client capabilities return platform-specific values preventing tracking via Touch ID, Bluetooth authenticator, and payment extension detection | [ADVANCED_FEATURES](ADVANCED_FEATURES.md#complete-fingerprint-control) |\n\n**Fingerprint Protection Matrix: Cross-Platform Coverage**\n\n| Category | Sample Capabilities |\n|----------|---------------------|\n| **Graphics** | Canvas/WebGL rendering, GPU micro-benchmarks, texture hash configuration |\n| **Network** | WebRTC SDP configuration, proxy auth, connection management |\n| **Platform** | Font fallback chains, cross-worker protection, OS-specific features |\n| **Performance** | FPS simulation, memory timing, animation frame optimization |\n\n\u003c/details\u003e\n\n\n**[Advanced Features (architecture \u0026 design) →](ADVANCED_FEATURES.md)** | **[CLI Flags (all options) →](CLI_FLAGS.md)**\n\n\n\n---\n\n## Fingerprint Protection Validation\n\nFingerprint protection validated across 31+ tracking scenarios. See [DISCLAIMER](DISCLAIMER.md) for authorized use.\n\n\u003ctable cellspacing=\"0\" cellpadding=\"8\"\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"20%\"\u003e\u003cstrong\u003e\u003ca href=\"tests/tests/antibots/cloudflare.spec.ts\"\u003eCloudflare Protection Validation\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd width=\"30%\"\u003e\u003ca href=\"//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-cloudflare-turnstile\"\u003e▶️ Validation Recording\u003c/a\u003e\u003c/td\u003e\n    \u003ctd width=\"20%\"\u003e\u003cstrong\u003e\u003ca href=\"tests/tests/antibots/creepjs.spec.ts\"\u003eCreepJS Fingerprint Analysis\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd width=\"30%\"\u003e\u003ca href=\"//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-creepjs-creepjs\"\u003e▶️ Desktop Protection\u003c/a\u003e / \u003ca href=\"//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-creepjs-creepjs-Android\"\u003e▶️ Android Profile\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"20%\"\u003e\u003cstrong\u003e\u003ca href=\"tests/tests/antibots/datadome.spec.ts\"\u003eDataDome Detection Environment\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd width=\"30%\"\u003e\u003ca href=\"//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-datadome-fifa\"\u003e▶️ Scenario Analysis\u003c/a\u003e\u003c/td\u003e\n    \u003ctd width=\"20%\"\u003e\u003cstrong\u003e\u003ca href=\"tests/tests/antibots/fingerprintjs.spec.ts\"\u003eFingerprintJS Pro Analysis\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd width=\"30%\"\u003e\u003ca href=\"//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-fingerprintjs-botdetection\"\u003e▶️ Tracking Methodology\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"20%\"\u003e\u003cstrong\u003e\u003ca href=\"tests/tests/antibots/perimeterx.spec.ts\"\u003ePerimeterX Protection Study\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd width=\"30%\"\u003e\u003ca href=\"//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-perimeterx-zillow\"\u003e▶️ Protection Validation\u003c/a\u003e\u003c/td\u003e\n    \u003ctd width=\"20%\"\u003e\u003cstrong\u003e\u003ca href=\"tests/tests/antibots/pixelscan.spec.ts\"\u003ePixelscan Fingerprint Assessment\u003c/a\u003e\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd width=\"30%\"\u003e\u003ca href=\"//botswin.github.io/BotBrowser/video_player/index.html?video=antibots-pixelscan-pixelscan\"\u003e▶️ Comprehensive Study\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n### Cross-Platform Protection Validation\n- **Windows Profile on macOS:** Fingerprint protection maintained so privacy defenses remain effective across platforms\n- **Android Emulation on Desktop (PRO):** Mobile API parity enables fingerprint testing for cross-device privacy research\n- **Headless vs GUI Mode:** Identical fingerprint behavior ensures privacy validation results remain effective across execution contexts\n\n**[Complete Validation Results \u0026 Research Data →](VALIDATION.md)**\n\n---\n\n## Engine Internals\n\nBotBrowser's engine is built in-house on top of Chromium, with no forks or external project dependencies. Selected patch examples, build configurations, and the Chromium source directory tree are published in [patches/](patches/). The full core remains proprietary.\n\n---\n\n## Resources \u0026 Support\n\n### Documentation\n\n- [Installation Guide](INSTALLATION.md) - Platform-specific setup, Docker deployment, troubleshooting\n- [Advanced Features](ADVANCED_FEATURES.md) - Architecture and design details\n- [CLI Flags Reference](CLI_FLAGS.md) - Core and extended runtime flags with examples\n- [Profile Configuration](profiles/PROFILE_CONFIGS.md) - Profile JSON field reference\n- [Validation Results](VALIDATION.md) - Research data across 31+ tracking scenarios\n- [Performance Benchmark](BENCHMARK.md) - Speedometer 3.0, fingerprint API overhead, and scale performance data\n\n### Support Channels\n\n\u003ctable\u003e\n  \u003ctr\u003e\u003ctd\u003eEmail\u003c/td\u003e\u003ctd\u003eTechnical questions, source code access\u003c/td\u003e\u003ctd\u003e\u003ca href=\"mailto:support@botbrowser.io\"\u003esupport@botbrowser.io\u003c/a\u003e\u003c/td\u003e\u003c/tr\u003e\n  \u003ctr\u003e\u003ctd\u003eTelegram\u003c/td\u003e\u003ctd\u003eCommunity support, quick questions\u003c/td\u003e\u003ctd\u003e\u003ca href=\"https://t.me/botbrowser_support\"\u003e@botbrowser_support\u003c/a\u003e\u003c/td\u003e\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Responsible Use\n\n- Review the detailed [Responsible Use Guidelines](RESPONSIBLE_USE.md) and [Legal Disclaimer](DISCLAIMER.md) before requesting binaries or premium profiles.\n- Maintain written authorization for every environment you test, and record the synthetic data sets you rely on.\n- Contact the maintainers at [support@botbrowser.io](mailto:support@botbrowser.io) if you observe suspicious activity or need to report an abuse incident.\n\n**[Legal Disclaimer \u0026 Terms of Use](https://github.com/botswin/BotBrowser/blob/main/DISCLAIMER.md) • [Responsible Use Guidelines](https://github.com/botswin/BotBrowser/blob/main/RESPONSIBLE_USE.md)**. BotBrowser is for authorized fingerprint protection and privacy research only.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotswin%2Fbotbrowser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbotswin%2Fbotbrowser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotswin%2Fbotbrowser/lists"}