Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/middleschoolstudent/botbrowser
BotBrowser modifies Chromium's C++ kernel to emulate a real browser, bypassing Cloudflare, F5 Shape, PerimeterX, Akamai, Kasada, and reCAPTCHA with unmatched stealth and reliability.
https://github.com/middleschoolstudent/botbrowser
adscore akamai antibot automation bypass cloudflare datadome fingerprint incapsula kasada perimeterx playwright puppeteer recaptcha scraping shapesecurity stealth
Last synced: 6 days ago
JSON representation
BotBrowser modifies Chromium's C++ kernel to emulate a real browser, bypassing Cloudflare, F5 Shape, PerimeterX, Akamai, Kasada, and reCAPTCHA with unmatched stealth and reliability.
- Host: GitHub
- URL: https://github.com/middleschoolstudent/botbrowser
- Owner: MiddleSchoolStudent
- License: mit
- Created: 2024-09-08T11:24:03.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-01-08T22:43:12.000Z (14 days ago)
- Last Synced: 2025-01-09T10:14:49.889Z (13 days ago)
- Topics: adscore, akamai, antibot, automation, bypass, cloudflare, datadome, fingerprint, incapsula, kasada, perimeterx, playwright, puppeteer, recaptcha, scraping, shapesecurity, stealth
- Language: TypeScript
- Homepage: https://t.me/middle_student
- Size: 556 MB
- Stars: 96
- Watchers: 6
- Forks: 16
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
🤖 BotBrowser
The Ultimate Solution for Undetectable Automated Browsing 🚀
---
## What is BotBrowser?
BotBrowser is a powerful, cross-platform browser automation tool that revolutionizes how we interact with web automation. By directly modifying Chromium's native C++ source code, it achieves what traditional JavaScript-based CDP ([Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/)) solutions can't - true undetectable automation.
## Simplified Management
To make your automation journey even smoother, we've created [BotBrowserConsole](console) - a free and open-source GUI tool that puts power at your fingertips:
- Launch multiple browser instances with ease
- Manage different environments seamlessly
- Handle multiple accounts efficiently
---
## 🚀 Features
### 🎯 Core Features
- **Cross-Platform Compatibility**
> Fully supports Windows, macOS, and Ubuntu, enabling seamless cross-platform use of profiles. Start on one system and continue effortlessly on another.
- **Latest Chromium Base**
> Stays updated with the latest stable Chrome/Chromium versions to ensure compatibility with advanced antibot defenses.
- **Advanced Programmatic Control**
> Dual advantage: Leverages CDP for powerful automation with [Playwright](demo/playwright) and [Puppeteer](demo/puppeteer), while preventing CDP leak detection - perfect balance of control and undetectability.
- **Success & Performance**
> Real client success stories validate our exceptional performance: **98%+ success rate** against advanced antibots with over **350,000 accounts registered daily**, demonstrating unmatched efficiency and reliability under high loads.
### 🛡️ Advanced Capabilities
#### 🕵️ Stealth and Detection Evasion
- **Bypass incognito mode checks**
> Ensures undetectable automation even in headless or incognito modes.
- **Customizable browsing history**
> Enables realistic, dynamic histories for diverse fingerprinting scenarios.
- **Noise injection**
> Randomizes 2D canvas, WebGL, emoji, fonts, text metrics, and audio fingerprints to avoid detection.
- **Simulated OS-specific properties**
> Adjusts scrollbar width, BarcodeDetector, and system-specific settings for enhanced authenticity.
- **Content Decryption Module (CDM) bypass**
> Avoids detection by DRM systems.
#### 🌐 Comprehensive Proxy and Network Control
- **Proxy integration**
> Easily configure proxy host, username, and password without relying on CDP.
- **Dynamic language and timezone settings**
> Automatically adapt browser environment based on proxy IP for realistic geolocation.
- **WebRTC leak protection**
> Prevents exposure of real IPs during WebRTC communication.
#### 🎯 Fingerprint Spoofing Capabilities
> BotBrowser provides comprehensive fingerprint emulation for:
- **Browser**: Version, OS, userAgentData
- **Graphics**: WebGL, WebGL2, GPU
- **Hardware**: Screen, Battery, Keyboard, CPU
- **Environment**: Permissions, FeaturePolicy, SystemFonts
- **Media**: MediaDevices, MimeTypes
- **Visuals**: Emoji, Unicode, System Colors
- **Others**: Navigator, Window, and more
---
## 🚀 Usage
1. **Download**
> Get the installer for your OS from [Releases](https://github.com/MiddleSchoolStudent/BotBrowser/releases) page.
2. **Profiles**
> We provide sample [Profiles](profiles) for demonstration purposes.
3. **Launching BotBrowser**
> Simply pass your profile via `--bot-profile` parameter to unlock ultimate browser stealth:
```bash
chromium --bot-profile="{path_of_}/chrome131_win11_x64.enc"
```
> Once launched with this flag, your browser instantly gains complete stealth capabilities - making it invisible to all antibot detection systems while maintaining full automation functionality.
💡 **Pro Tip**:
> Profiles generated for macOS, Windows, and Ubuntu binaries are **cross-compatible**, enabling seamless fingerprint emulation across systems. For example, you can use a macOS profile on Ubuntu or a Windows profile on macOS **without any compatibility issues**.
4. **Demo Integrations**
> Explore BotBrowser's integration examples with popular automation tools:
- **[Playwright Demo](demo/playwright)**
> Quickly get started with Playwright to automate repetitive browser tasks using BotBrowser.
- **[Puppeteer Demo](demo/puppeteer)**
> Seamlessly integrate Puppeteer for advanced browser automation and testing.
- **[Tests](tests)**
> Use our detailed test scripts to explore real-world use cases and implementation examples.
---
## 🎯 Proven Effectiveness
### 🧪 Code and Video Test Results
BotBrowser has been extensively tested against leading antibot systems. Below are detailed test results and video demonstrations:
| Service & Scripts | Test Results |
|-----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **[Cloudflare](tests/tests/antibots/cloudflare.spec.ts)** | [▶️ Turnstile](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=cloudflare-test-Cloudflare-turnstile), [▶️ Challenge](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=cloudflare-test-Cloudflare-challenge), [▶️ taxslayer.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=cloudflare-test-taxslayer) |
| **[Akamai Bot Manager](tests/tests/antibots/akamai.spec.ts)** | [▶️ playstation.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=akamai-test-playstation-com), [▶️ wizzair.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=kasada-test-Kasada-wizzair-com-) |
| **[Kasada](tests/tests/antibots/kasada.spec.ts)** | [▶️ kick.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=kasada-test-Kasada), [▶️ playstation.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=akamai-test-playstation-com), [▶️ wizzair.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=kasada-test-Kasada-wizzair-com-) |
| **[F5 Shape Security](tests/tests/antibots/shape.spec.ts)** | [▶️ southwest.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=shape-test-Shape-southwest-com-) |
| **[reCAPTCHA](tests/tests/antibots/recaptcha.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=recaptcha-test-reCAPTCHA-v3-on-antcpt) |
| **[PerimeterX](tests/tests/antibots/perimeterx.spec.ts)** | [▶️ textnow.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=perimeterx-test-PerimeterX) |
| **[Imperva (Incapsula)](tests/tests/antibots/incapsula.spec.ts)** | [▶️ copaair.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=incapsula-test-Incapsula-copaair-com-) |
| **[DataDome](tests/tests/antibots/datadome.spec.ts)** | [▶️ shutterstock.com](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=datadome-test-shutterstock-com) |
| **Cloudfront Bot Management (AWS)** | 🚧 Coming Soon |
| **hCaptcha** | 🚧 Coming Soon |
| **ThreatMetrix** | 🚧 Coming Soon |
| **Adscore** | 🚧 Coming Soon |
| **ProtectedMedia** | 🚧 Coming Soon |
| **[Fake Vision](tests/tests/antibots/fvpro.spec.ts)** | [▶️ fv.pro](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=fvpro-test-fv-pro) |
| **[FingerprintJS](tests/tests/antibots/fingerprintjs.spec.ts)** | [▶️ Bot Detection](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=fingerprintjs-test-fingerprintjs-bot-detection) |
| **[CreepJS](tests/tests/antibots/creepjs.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=creepjs-test-creepjs) |
| **[BrowserScan](tests/tests/antibots/browserscan.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=browserscan-test-browserscan) |
| **[Pixelscan](tests/tests/antibots/pixelscan.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=pixelscan-test-pixelscan) |
| **[iphey](tests/tests/antibots/iphey.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=iphey-test-iphey) |
| **[brotector](tests/tests/antibots/brotector.spec.ts)** | [▶️ Test Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=brotector-test-Brotector) |
### 🌐 Top Platforms and Websites
The following platforms have been tested:
| Service & Scripts | Anti-bot Services | Test Results |
|------------------|-------------------|--------------|
| **[Nike](tests/tests/websites/nike.spec.ts)** | F5 Shape Security | ✅ Success [▶️ Checkout Video](https://middleschoolstudent.github.io/BotBrowser/video_player/index.html?video=websites-nike-test-nike-com-checkout) |
| **TikTok** | Generic Antibot | ✅ Success |
| **Temu** | F5 Shape Security | ✅ Success |
| **LinkedIn** | Generic Antibot | ✅ Success |
| **Ticketmaster** | PerimeterX, FingerprintJS, reCAPTCHA | ✅ Success |
| **Shein** | F5 Shape Security, FingerprintJS, Forter | ✅ Success |
| **Facebook** | Generic Antibot | ✅ Success |
| **Bet365** | Generic Antibot | ✅ Success |
...and many more
---
## 📚 Additional Resources
### 🔐 Profile Generation
We do not provide the private key required to generate new profiles. If you need additional profiles, please contact us directly. We maintain a repository of over **300,000 real user browser fingerprints** to support your needs.
**📞 Contact us today:**
| 📧 Email | [[email protected]](mailto:[email protected]) |
|-------------|--------------------------------------------------|
| 📱 Telegram | [middle_student](https://t.me/middle_student) |
### 🛠️ Building from Source
If you wish to compile your own version of Chromium with our modifications, follow the instructions provided [here](build).
---
## ⚠️ Disclaimer
BotBrowser is intended for legitimate use cases that comply with all applicable laws and regulations. Misuse of this tool to violate the terms of service of websites or engage in illegal activities is strictly prohibited.
---
Antibots are making the world worse.
---
