🚀 BotBrowser 138 20250731

This update introduces brand emulation, deep GPU/CPU spoofing enhancements, and key Android and locale fixes — see CHANGELOG.md for full details.

✨ New Features

• 🎨 Browser Brand Config: Select chromium, chrome, brave, or edge with configs.browserBrand for precise brand spoofing.
• 🦁 Brave & 🔷 Edge Simulation: Perfectly emulate Brave and Edge browsers, including brand-specific identifiers and APIs.
• 🌐 WebKit Emulation: Adds basic Safari/WebKit behaviors for broader compatibility.
• 🔀 Random History Injection: configs.injectRandomHistory generates authentic navigation history on each new page.

🛠️ Improvements

• ⚙️ CPU Core Count Simulation: Accurate logical core spoofing per profile to bypass advanced fingerprint checks.
• 🎮 WebGPU Capabilities: Simulates key WebGPU storage buffer and texture limits for fragment and vertex stages.
• 📐 Android Window Defaults: Uses profile-defined dimensions for Android simulations, ensuring exact render sizes.
• 🚫 Debugger Blocking: Blocks JS debugger calls to avoid detection of DevTools or automation.

🐞 Fixes

• 🔧 Android DevTools Mode: Fixes DevTools docking crash on Android emulations.
• 🌍 Auto Language/Locale Sync: Ensures configs.languages = "auto" consistently updates locale settings.
• 🕸️ Iframe WebRTC IP Leak: Fixed a WebRTC local IP leak when running inside iframes.

📄 Full changelog: CHANGELOG.md

---

🎯 Upgrade Recommendation

Upgrade now to leverage comprehensive brand emulation, refined hardware spoofing, and critical stability fixes for Android and locale synchronization. Stay undetectable! 🚀

🚀 BotBrowser 138 20250722

This release brings a critical core upgrade and a stability fix:

✨ Major Update

• Chromium 138 Upgrade: Synced to Chromium 138 for perfect stealth and compatibility. (Maintains feature parity with upstream Chrome.)

🐞 Bug Fix

• System UI Font Simulation Crash: Prevents renderer crashes when emulating UI fonts. (Enhances reliability during fingerprint spoofing.)

📄 For more details, see: CHANGELOG.md

---

🎯 Upgrade Recommendation

Upgrade now to enjoy the latest Chromium enhancements and improved stability in UI font emulation.

🚀 BotBrowser 137 20250804

This release brings macOS behavior improvements, key WebRTC and locale fixes, enhanced proxy and language configuration, and new automation-friendly flags.

🛠️ Improvements

• ⚙️ macOS Auto-Quit on Last Tab
  Ensures BotBrowser closes natively on macOS when the final tab is closed.

🐞 Bug Fixes

• 🔧 WebRTC IPv6 SDP Bypass
  Fixes IPv6 candidate spoofing in SDP to reliably evade Kasada and other antibots.

• 📈 Locale Crash
  (#52) Resolves crashes triggered by setting configs.locale = "en-CA".

✨ New Features

• 🌐 Embedded Proxy Credentials
  (#50) --proxy-server and configs.proxy.server accept credentials in the URL (e.g., user:pass@ip:port, socks5://user:pass@ip:port), no longer need to set proxy-username and proxy-password.

• 🌍 Auto Language Detection
  configs.languages = "auto" automatically syncs browser language settings with proxy IP location.

• 🔍 Google Header Emulation
  Automatically injects X-Browser-Validation headers on google domains for anti-scraping bypass.

• 🔖 Bookmarks Loader
  --bot-bookmarks loads bookmarks from a JSON file at startup.

• 🏷️ Custom Title
  --bot-title sets both window title and icon badge, aiding session identification.

📄 For more changes, see: CHANGELOG.md

---

🎯 Upgrade Recommendation

Upgrade now to enjoy smoother macOS behavior, robust WebRTC spoofing, locale stability, advanced proxy/language automation, and UI enhancements for headless workflows.

🚀 BotBrowser 137 20250714

This release adds robust proxy/auth features, advanced fingerprint controls, critical bug fixes, and core improvements to outsmart the latest antifraud systems. For details, see CHANGELOG.md.

✨ Added

• 🔐 SOCKS5 Proxy Authentication: Support for username/password on SOCKS5 proxies.
• 🔧 Proxy Credentials CLI Flags: New --proxy-username & --proxy-password alongside --proxy-server, no profile edits needed.
• 🍪 Bot Cookies Flag: --bot-cookies to load cookies at launch.
• 🎛️ Real/Noise Config Toggles (#44): Toggle fingerprint vectors between real and noise in profile configs.

🛠️ Improved

• 🌐 Proxy IP & WebRTC Refactor: Reliable public-IP spoofing in WebRTC contexts created via automation frameworks.
• ⏰ autoTimezone Consistency: Ensures IP-based timezone detection always applies.
• 🎨 WebGL Version Forgery: Spoofs shadingLanguageVersion & version in WebGL/WebGL2.
• 🛡️ Imperva Strict Mode Fix: Noise injection adjusted for Imperva’s strict fingerprint checks.
• 🌍 configs.languages Fix: Correct application of language settings in HTTP and JS APIs.
• 📁 Relative Path Support: Relative paths work with --bot-profile.
• 📂 User-Data-Dir Stability: Fixed intermittent profile directory mount failures.
• 🔌 WebGL Extension Refactor: Bypasses FingerprintJS Pro via improved extension parameter spoofing.
• 🎚️ Cross-Platform Toggles: Granular OS-specific feature toggles to avoid FPJS Pro tampering flags.
• 🔤 System Default Fonts: Per-OS default fonts tuned to defeat advanced font-based checks.

🐞 Fixed

• 📸 Screenshot Clip Respect: captureScreenshot now respects clip parameters when using profile-defined window/screen sizes.

🔧 Example configs

{
  "configs": {
    // Browser locale
    "locale": "en-US",

    // Accept-Language header values
    "languages": ["en-US"],

    // Color scheme: 'light' or 'dark'
    "colorScheme": "light",

    // Proxy settings: scheme://hostname:port, with optional basic auth
    "proxy": {
      "server": "1.2.3.4:8080",
      "username": "",
      "password": ""
    },

    // Disable GUI scaling based on device scale factor (ignore DevicePixelRatio for UI scaling)
    "disableDeviceScaleFactorOnGUI": false,

    // timezone: 'auto' = based on IP; 'real' = system timezone; any other string = custom
    "timezone": "auto",

    // location: 'auto' = based on IP; 'real' = system (GPS) location;
    // object = custom coordinates
    "location": "auto", // or "real" or { latitude: 8.8566, longitude: 2.3522 }

    // window: 'profile' = use profile’s dimensions;
    // 'real' = use system window size;
    // object = custom dimensions
    "window": "profile", // or "real" or { innerWidth: 1280, innerHeight: 720, outerWidth: 1280, outerHeight: 760, screenX: 100, screenY: 50, devicePixelRatio: 1 }

    // screen: 'profile' = use profile’s screen metrics;
    // 'real' = use system screen metrics;
    // object = custom metrics
    "screen": "profile", // or "real" or { width: 1280, height: 720, colorDepth: 24, pixelDepth: 24 }

    // WebRTC: 'profile' = profile’s settings; 'real' = native; 'disabled' = no WebRTC
    "webrtc": "profile",

    // Fonts: 'profile' = profile’s embedded list; 'real' = system-installed fonts
    "fonts": "profile",

    // WebGL: 'profile' = profile’s parameters; 'real' = system implementation; 'disabled' = off
    "webgl": "profile",

    // WebGPU: same semantics as WebGL
    "webgpu": "profile",

    // Media devices: 'profile' = fake camera/mic devices; 'real' = actual system devices
    "mediaDevices": "profile",

    // Speech voices: 'profile' = profile’s synthetic voices; 'real' = system voices
    "speechVoices": "profile",

    // noiseCanvas: true adds subtle noise to Canvas fingerprint; false disables it
    "noiseCanvas": true,

    // noiseWebglImage: true adds noise to WebGL image fingerprint; false disables it
    "noiseWebglImage": true,

    // noiseAudioContext: true adds noise to AudioContext fingerprint; false disables it
    "noiseAudioContext": true,

    // noiseClientRects: true adds noise to clientRects fingerprint; false disables it
    "noiseClientRects": false,

    // noiseTextRects: true adds noise to TextRects fingerprint; false disables it
    "noiseTextRects": true
  }
}

📄 Full changelog: https://github.com/MiddleSchoolStudent/BotBrowser/blob/main/CHANGELOG.md

---

🎯 Upgrade Recommendation

Upgrade now to leverage these new proxy/auth controls, fingerprint refinements, and stability fixes to stay ahead of evolving antifraud defenses.

🚀 BotBrowser 137 20250616

This release optimizes proxy handling by moving geo-lookup and timezone resolution to page load time, reducing startup latency and supporting per-context proxy configurations for advanced scraping workflows.

🛠️ Improvements

• On-Demand Proxy Geo & Timezone Fetch
  • Proxy’s latitude/longitude, timezone, and public IP are now retrieved when a page is opened using an interceptor.
  • Avoids delays at browser launch and allows each BrowserContext to independently set and resolve proxy details.

📄 For the full list of changes, see: CHANGELOG.md

---

🎯 Upgrade Recommendation

Upgrade to this version to enjoy faster startup times and more flexible, per-context proxy usage without sacrificing stealth or accuracy.

🚀 BotBrowser 137 20250610

This release delivers a critical core upgrade to Chromium 137 and unlocks headless GPU simulation in pure software mode-no hardware or X server required.

✨ Major Update

• Chromium 137 Upgrade
  BotBrowser now runs on Chromium 137, matching the latest Chrome release for perfect stealth and up-to-date web compatibility.

🛠️ Major Improvement

• GPU Simulation Without Hardware or XDISPLAY
  Linux builds now simulate GPU functionality entirely in software.
  • No physical GPU needed
  • No XDISPLAY or graphical server required
  • Ensures accurate GPU fingerprints and accelerated rendering in headless CLI environments

📄 For the full list of changes, see: CHANGELOG.md

---

🎯 Upgrade Recommendation

Upgrade now to benefit from the latest Chromium enhancements and true headless GPU simulation—essential for Docker, CI, and server-only deployments.

🚀 BotBrowser 136 20250601

This release delivers a massive fingerprinting breakthrough - rebuilding the browser's WebRTC core and unlocking A+ level stealth on CreepJS, along with key antifraud bypass fixes and powerful new location/geolocation tools.

🔥 Highlights

• 🔐 Fully Refactored WebRTC Stack

  • Zero local IP leakage - uses proxy IP to simulate public IPv4/IPv6.
  • Media capabilities (audio, video) are fully simulated via profile.
  • 🌟 BotBrowser now scores 100% / A+ on ▶️ CreepJS.

• 🛰️ GeoLocation via IP

  • No need to manually spoof your location - BotBrowser uses your proxy’s IP GEO info to simulate navigator.geolocation.

• 🧩 Extensions in Incognito Mode

  • Extensions are now auto-enabled even in incognito contexts and Playwright/Puppeteer sessions.

🛠️ Additional Improvements

• 🛡️ Patched a Kasada-detectable fingerprint leak.
• 🧱 Major upgrade to permissions simulation (notifications, mic, etc).
• 🌐 IP GEO & WebRTC info now refreshes correctly when opening new tabs.
• 🧽 Blocked sensitive Google API calls to avoid activity leaks.
• 🏷️ Added BotBrowser Build Date in chrome://version.

📄 For full details: CHANGELOG.md

---

🎯 Why Upgrade?

If you care about:

• Passing CreepJS / Kasada / WebRTC-based detection
• Consistent stealth across tabs and tools
• Powerful location fingerprinting

➡️ This update is for you.

🚀 BotBrowser 136 20250513

This release brings a major boost to environmental realism, including automatic timezone alignment, OS-specific font rendering, and smarter profile handling.

✨ New Features

• 🌍 Auto Timezone Detection

  • BotBrowser can now query IP-based geolocation (proxy exit IP) and automatically set the correct timezone and city, avoiding mismatches in location-based fingerprinting.
  • Controlled by configs.autoTimezone (enabled by default). See profile-configs.md

• 🌓 Color Scheme Configuration

  • Set browser theme to dark or light using configs.colorScheme. Uses profile’s default if not specified.

🛠️ Improvements

• ✅ Bot-Profile Validation

  • Detects missing or malformed --bot-profile values and exits gracefully with clear error messages.

• 📁 Relative Path Support

  • --bot-profile now supports relative paths, making integration more convenient across systems.

• 🖋️ Cross-Platform Font Simulation

  • Built-in Windows/macOS/Android font libraries can be emulated on any OS based on the profile’s target platform.
  • Prevents font mismatch detection and visual rendering differences.

• 🎯 Hardened matchMedia Injection

  • matchMedia parameters are now reliably injected via WebPreferences. Improves stealth and fixes edge-case loading issues.

• 🧱 System UI Font Emulation

  • Better cross-platform simulation of system-level UI fonts (kMenu, kStatusBar, etc.) for deeper antifraud resistance.

🐞 Bug Fixes

• 💥 Renderer Stack Overflow Crash Fix
  Fixed a rare but critical issue where some websites caused renderer process crashes due to JavaScript stack overflow. BotBrowser now prevents these crashes cleanly.

📄 See full details in: CHANGELOG.md

---

🎯 Upgrade Recommendation

This is a high-priority update for users simulating cross-OS environments or targeting antifraud systems sensitive to timezone, fonts, or system UI appearance.
Upgrade now to stay fully undetectable and environment-accurate. ✅

🚀 BotBrowser 136 20250501

This update focuses on keeping BotBrowser aligned with the latest browser standards by upgrading the core engine to Chromium 136.

🛠️ Core Improvement

• Chromium 136 Upgrade
  • BotBrowser is now built on Chromium 136, ensuring compatibility with the newest Chrome features, performance optimizations, and security patches.
  • Improves stealth and fingerprint accuracy by mirroring the latest Chrome implementation.

📄 For more details, see the full changelog: CHANGELOG.md

---

🎯 Upgrade Recommendation

We recommend upgrading to this version to maintain maximum compatibility and stealth with the latest Chromium 136 core. Staying current ensures BotBrowser remains fully aligned with evolving antifraud detection methods.

🚀 BotBrowser 135 20250426

This release introduces deeper fingerprint simulation accuracy, new profile-based configurability, and key stability enhancements to keep BotBrowser ahead of modern antifraud systems.

🛠️ Improvements

• 🎵 Enhanced Audio Fingerprint Simulation
  • Audio noise has been further optimized to accurately mimic real-world fingerprints, successfully bypassing systems like FunCaptcha.

🐞 Bug Fixes

• 🧩 mimeTypes Fingerprint Handling
  • Fixed MIME type inconsistencies that could trigger detection by advanced antifraud frameworks.

✨ New Features

• 🌐 Custom Remote Debugging Address Support

  • --remote-debugging-address now supports binding to custom IPs like 0.0.0.0, making BotBrowser ideal for Scraping API deployments.

• 🖥️ Profile-Based Window and Screen Size Configuration

  • New support for defining window size, screen size, device pixel ratio, and related properties directly through profiles, eliminating reliance on CDP or command-line arguments.
  • 📖 See detailed profile configuration guide: profiles/profile-configs.md

📄 For the complete list of changes, please see: CHANGELOG.md

---

🎯 Upgrade Recommendation

This update is highly recommended for users seeking improved fingerprint stealth, better API integration capabilities, and enhanced control over window/screen-related fingerprinting surfaces.