BotBrowser  by botswin

Browser core providing unified fingerprint defense

Created 1 year ago
2,457 stars

Top 18.2% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

BotBrowser is an advanced privacy browser core designed to combat sophisticated browser fingerprinting techniques. It provides users and researchers with an identical privacy posture across any operating system, ensuring tracking systems cannot correlate data to identify individuals. This offers a significant benefit for privacy-conscious users, security researchers, and those conducting defensive benchmarking.

How It Works

Built in-house on the latest stable Chromium, BotBrowser employs a unified fingerprint technology to maintain consistent signals across Windows, macOS, Linux, and Android WebView. Its core approach involves high-fidelity, always-current profiles, network stack parity with QUIC/STUN tunneling, and advanced programmatic control via Playwright/Puppeteer integration with CDP leak blocking. Novel features like Per-Context Fingerprint enable independent fingerprint bundles per BrowserContext, while the Mirror feature allows for distributed privacy consistency checks.

Quick Start & Requirements

Download the latest release for your OS. Launch via the GUI (BotBrowserLauncher) or CLI (e.g., chrome.exe --bot-profile="C:\absolute\path\to\profile.enc"). Requires a demo profile (.enc file) and absolute paths for CLI usage. Full installation details are in INSTALLATION.md. Performance claims include Speedometer 3.0 within <1% of stock Chrome and 29% memory savings at scale. Official documentation is available at botbrowser.io.

Highlighted Details

  • Unified Fingerprint Defense: Protects against Cloudflare, Akamai, Kasada, Shape, DataDome, PerimeterX, hCaptcha, FunCaptcha, Imperva, reCAPTCHA, ThreatMetrix, Adscore.
  • Cross-Platform Parity: Ensures identical UA, screen metrics, fonts, and device APIs across Windows, macOS, Linux, and Android WebView.
  • Advanced Automation: Integrates with Playwright/Puppeteer, offering CDP leak blocking and framework-less bot-scripting via CDP.
  • Performance: Achieves zero-overhead performance, matching stock Chrome Speedometer 3.0, with significant memory savings via Per-Context Fingerprint.
  • Network Features: Supports QUIC/STUN tunneling over SOCKS5, local DNS solver, and WebRTC leak protection.

Maintenance & Community

The project is built in-house on Chromium with no external dependencies for its core. Community support and quick questions are handled via Telegram (@botbrowser_support). Technical questions and source code access inquiries can be directed to support@botbrowser.io.

Licensing & Compatibility

The specific open-source license is not explicitly stated in the provided README. The core engine is proprietary. Compatibility is high across major operating systems (Windows, macOS, Linux, Android WebView) with a focus on consistent privacy posture.

Limitations & Caveats

The core engine is proprietary, limiting full open-source inspection. Usage is restricted to authorized fingerprint protection and privacy research, requiring written authorization for testing environments. The absence of a clear license may pose adoption challenges for some organizations.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
0
Star History
91 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.