# GodBrowser > GodBrowser is a patched Chromium 147 anti-fingerprint browser. It ships per-profile, deterministic, internally-coherent device fingerprints across 5 OSes (Windows / macOS / Linux / iOS / Android) and 5 browser engines (Chrome / Safari / Firefox / Samsung Internet / Edge), and silently passes the major protection stacks (PerimeterX, DataDome, Cloudflare, Akamai, and more). It also auto-solves captchas in-browser. You integrate with it exactly like Chrome — launch it with flags, or drive it over the standard Chrome DevTools Protocol (CDP). Integrate like Chrome: launch with flags, or drive over CDP (Chrome DevTools Protocol). Public human guide: https://godbrowser.io/integrate ## Quick start - Get the build (access-controlled): # GodBrowser binaries are access-gated; request access for the install one-liner + signed builds. # The integration info on this page is public; the binaries are not publicly distributed. Once you have the build, the usage below applies as-is. - Run a persona at a URL (wrapper): ./tools/run_godbrowser.sh --bot-os=macos --bot-browser=chrome https://example.com # The wrapper sets sane defaults (mock-keychain, captcha-on-if-key-present, etc.) and forwards any --bot-* flag. - Run the raw binary directly: /Applications/GodBrowser.app/Contents/MacOS/GodBrowser --bot-os=windows --bot-browser=firefox https://example.com # Every --bot-* flag works on the raw binary too; the wrapper is optional convenience. - Deterministic persona (reproducible fingerprint): GodBrowser --bot-profile= https://example.com # A given seed always yields the identical coherent persona (UA, fonts, canvas, audio, WebGL, locale, timezone…). - Automate over CDP (the integration path): GodBrowser --remote-debugging-port=9222 --remote-allow-origins=* --bot-profile=s7 https://example.com # Connect Puppeteer/Playwright/any CDP client to ws://127.0.0.1:9222 (the --remote-allow-origins=* is required for programmatic DevTools-WS clients). isTrusted input + the FP spoofing are native (not CDP-injected), so they survive automation. ## Personas - --bot-os= windows|macos|linux|ios|android - --bot-browser= chrome|safari|firefox|samsung|edge (valid OS×browser subset only) - --bot-profile= deterministic coherent device (same seed => same fingerprint) - --bot-config-locale=, --bot-egress-countries= ## Captcha auto-solve Captcha auto-solve is built in. Provide a solving-service key via an env var (or --bot-captcha-key-file=) and it auto-solves reCAPTCHA-v2 + auto-clicks Cloudflare-managed Turnstile checkboxes with no host sidecar. The wrapper turns it on automatically when a key is present (read from .env). Opt out with GB_CAPTCHA_OFF=1 or --bot-captcha-auto=off. The key is read browser-process-only and never reaches the renderer, page, command line, or logs. ## Proxy / geo egress For geo-coherent egress, set GODBROWSER_PROXY_SEED= in the environment and pick a country with --bot-proxy-seed-country= (the wrapper alias is --proxy-country=XX). The persona locale + timezone + Accept-Language are made coherent with the chosen exit country automatically. A static upstream proxy is --bot-proxy= (no seed→locale resolution). ## Automation / integration - CDP / Puppeteer / Playwright: launch with --remote-debugging-port= and attach normally. The anti-fingerprint layer and trusted input are in the C++/V8 core, so they are present under automation (no JS injection a detector could catch). - Headless: supported via --headless=new (use --enable-automation for headless dump/eval flows). - Per-request isolation: one --bot-profile (or --user-data-dir) per identity; each profile is a stable, distinct, coherent device. - Server-side coherence: JA4/TLS, HTTP/2 (Akamai-H2), and peetprint are aligned byte-for-byte with the real target browser — your proxy/egress just needs to be geo-coherent. - Verifying a persona: open the browser at creepjs / fp-scanner / the target site; GodBrowser is designed to read as a real device (CreepJS headless_rating 0, 0 lies on Chrome personas). ## Environment variables - --bot-captcha-key-file solving-service key for in-browser auto-solve (browser-process only) - GB_CAPTCHA_OFF=1 disable captcha auto-solve - GODBROWSER_PROXY_SEED proxy template URL (seed->locale->egress resolution) - GB_BIN (wrapper) path to a specific binary ## Parameters (139 total) Full machine-readable dump: https://godbrowser.io/llms-full.txt Key flags by family: - bm: --bm-auth-file, --bm-capture-all, --bm-client, --bm-device-name, --bm-disable, --bm-ingest-url, --bm-self-test - bot: --bot-always-active, --bot-audio-noise-seed, --bot-auto-print-seed, --bot-block-resources, --bot-bookmarks, --bot-browser, --bot-browser-version, --bot-cookies, --bot-custom-headers, --bot-direct-resources, --bot-egress-countries, --bot-enable-webrtc, … (+34) - bot-captcha: --bot-captcha-auto, --bot-captcha-key-file, --bot-captcha-provider, --bot-captcha-proxy, --bot-captcha-timeout, --bot-captcha-types - bot-config: --bot-config-architecture, --bot-config-bitness, --bot-config-browser-brand, --bot-config-color-scheme, --bot-config-disable-device-scale-factor, --bot-config-fonts, --bot-config-keyboard, --bot-config-languages, --bot-config-locale, --bot-config-location, --bot-config-media-devices, --bot-config-media-types, … (+12) - bot-config-noise: --bot-config-noise-audio-context, --bot-config-noise-canvas, --bot-config-noise-client-rects, --bot-config-noise-scale-audio-context, --bot-config-noise-scale-canvas, --bot-config-noise-scale-client-rects, --bot-config-noise-scale-text-rects, --bot-config-noise-scale-webgl-image, --bot-config-noise-text-rects, --bot-config-noise-webgl-image - bot-disable: --bot-disable-audio-sample-rate-spoof, --bot-disable-audio-spoof, --bot-disable-battery-spoof, --bot-disable-behavioral-jitter, --bot-disable-click-gaussian, --bot-disable-codec-spoof, --bot-disable-console-message, --bot-disable-debugger, --bot-disable-devmem-spoof, --bot-disable-document-hidden-spoof, --bot-disable-etld-noise, --bot-disable-fonts-spoof, … (+32) - other: --no-bot-auto, --title-id-prefix ## Getting the build This page (integration info + params) is public; the GodBrowser binaries are ACCESS-CONTROLLED, not publicly distributed. Request access to receive the install one-liner + signed macOS/Linux/Windows builds. The usage above applies once you have the build.