Skip to content

Commit d0459f3

Browse files
committed
docs: highlight webgpu noise and embedded fonts across guides
1 parent d4a4876 commit d0459f3

3 files changed

Lines changed: 16 additions & 8 deletions

File tree

ADVANCED_FEATURES.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -152,6 +152,7 @@ Sophisticated noise with consistency algorithms. Configure everything through CL
152152

153153
- **Canvas**: `--bot-config-noise-canvas=true`
154154
- **WebGL image**: `--bot-config-noise-webgl-image=true`
155+
- **WebGPU**: Deterministic noise is injected into WebGPU canvases by default, so GPU-only probes inherit the same reproducible noise field without extra flags
155156
- **AudioContext**: `--bot-config-noise-audio-context=true`
156157
- **ClientRects/TextRects**: `--bot-config-noise-client-rects=true`, `--bot-config-noise-text-rects=true`
157158
- **Deterministic seeds (ENT Tier2 feature)**: `--bot-noise-seed=1.05` (1.0–1.2 range) let you pick reproducible yet distinct noise fields for Canvas 2D/WebGL/WebGPU imagery, text metrics/HarfBuzz layout, ClientRects, and offline audio hashes so each seed behaves like its own fingerprint ID.
@@ -248,6 +249,7 @@ Advanced font rendering with consistent results across hosts.
248249
- Multi-language support (CJK/RTL/emoji)
249250
- Platform-specific font metrics
250251
- Consistent text measurement across workers
252+
- DOM text renders exclusively from the embedded Windows/macOS/Linux/Android font bundles so layouts never fall through to host fonts on the underlying machine
251253

252254
> **Implementation Detail:** Low‑level rendering paths in Skia (2D/Canvas) and HarfBuzz (text shaping) are tuned where needed to align metrics and glyph shaping across OS targets. We also apply targeted WebGL/WebGPU parameter controls to keep visual output stable across contexts.
253255
@@ -418,6 +420,7 @@ Comprehensive browser and OS emulation.
418420
| **Platform Detection** | Windows/macOS/Android emulation with authentic APIs |
419421
| **Browser Features** | Debugger disabling, CDP leak blocking, Chrome-specific behavior |
420422
| **Font System** | Built-in cross-platform fonts, Blink features, authentic fallback chains |
423+
| **Client Hints** | DPR, device-memory, UA-CH, and other CH values stay aligned with JavaScript-visible metrics so headers and runtime data always match |
421424

422425
### Location & Time Management
423426
Precise geolocation and temporal controls.

README.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -116,14 +116,15 @@ Examples: [Playwright](examples/playwright/) • [Puppeteer](examples/puppeteer/
116116
## 🛠️ Advanced Capabilities
117117
> **Professional-grade browser technology** through multi-layer fingerprint consistency, network-stack control, and automation-hardening.
118118
119-
- **Multi‑Layer Consistency:** Canvas/WebGL/Text metrics with low‑level Skia/HarfBuzz tuning and targeted WebGL/WebGPU controls
120-
- **Clean Automation:** CDP/WebDriver hardening, Chrome‑like behavior, and framework‑less early hooks via `--bot-script`
121-
- **Configurability:** 30+ CLI overrides, per‑context proxies (ENT Tier1) with automatic geo‑detection, and session tools (cookies/bookmarks/title)
122-
- **Headless ↔ GUI Parity:** Stable GPU/WebGPU/media signals and consistent behavior across browser modes
123-
- **Performance Controls:** Precise FPS simulation, memory/storage timing, and GPU micro‑benchmarks for realistic profiles; runtime timing scaling (ENT Tier1) and deterministic noise seeds (ENT Tier2)
124-
- **Focus & Session Control:** Always-active tab emulation, configurable WebRTC ICE servers, and expanded media decoder reporting for authentic runtime signals
125-
- **Network & Proxy Enhancements:** Per-context proxies (ENT Tier1) with auto geo detection; UDP-over-SOCKS5 tunnel for QUIC/STUN in ENT Tier3; ICE presets optional when UDP is available
126-
> **Professional-grade browser technology** through sophisticated multi-layer fingerprint consistency and cross-platform compatibility systems
119+
- **Multi‑Layer Noise**: Canvas/WebGL/WebGPU/Text/Audiocontext surfaces share deterministic, cross-worker noise with low-level Skia/HarfBuzz tuning
120+
- **Automation Hardening**: CDP/WebDriver artifact scrubbing, framework-less `--bot-script`, and console suppression PRO toggles keep detectors blind
121+
- **Configurable Stack**: 30+ CLI overrides, ENT Tier1 per-context proxies with auto geo, and session tooling (cookies/bookmarks/title/history)
122+
- **Typography Fidelity**: DOM text renders from embedded Windows/macOS/Android font packs so host fonts never leak during cross-OS simulation
123+
- **Client Hints Lockstep**: DPR/device-memory/UA-CH headers match JavaScript-visible values for airtight CH vs JS parity
124+
- **Headless ↔ GUI Parity**: Identical GPU/WebGPU/media signals across browser modes for stable automation baselines
125+
- **Performance Controls**: Precision FPS/memory timings plus ENT Tier1 timing/seed controls for reproducible benchmarks
126+
- **Focus & Session Control**: Always-active tabs, configurable ICE presets, and expanded media reporting keep sessions believable
127+
- **Network Enhancements**: ENT Tier1 per-context proxies, UDP-over-SOCKS5 (ENT Tier3), and SOCKS5H DNS-in-tunnel behavior for clean geo signals
127128

128129
<details>
129130
<summary><strong>Coverage Map: Detection Surfaces → Capabilities → Evidence</strong></summary>
@@ -135,11 +136,14 @@ This map links common detection surfaces to BotBrowser capabilities and the exac
135136
| navigator.webdriver | Removed/hidden at engine level | [ADVANCED_FEATURES#Chrome Behavior Emulation](ADVANCED_FEATURES.md#chrome-behavior-emulation) |
136137
| JS Execution Isolation | CDP/WebDriver artifact blocking | [ADVANCED_FEATURES#Playwright/Puppeteer Integration](ADVANCED_FEATURES.md#playwright-puppeteer-integration) |
137138
| Canvas/WebGL/WebGPU/Audio/Text metrics | Deterministic noise + parameter controls and cross‑worker consistency | [ADVANCED_FEATURES#Graphics & Rendering Engine](ADVANCED_FEATURES.md#graphics-rendering-engine) |
139+
| WebGPU fingerprinting | Canvas/WebGPU share deterministic noise so GPU-only probes like [WebBrowserTools](https://webbrowsertools.com/webgpu-fingerprint/) stay consistent | [CHANGELOG#2025-12-08](CHANGELOG.md#2025-12-08) |
138140
| Fonts/Text | Built-in fonts + HarfBuzz shaping | [ADVANCED_FEATURES#Cross-Platform Font Engine](ADVANCED_FEATURES.md#cross-platform-font-engine) |
141+
| DOM Font Enumeration | DOM text renders from embedded Windows/macOS/Linux/Android font bundles; host fonts never leak | [ADVANCED_FEATURES#Cross-Platform Font Engine](ADVANCED_FEATURES.md#cross-platform-font-engine) |
139142
| MediaDevices | Profile-based device spoofing | [Profile Configs](profiles/PROFILE_CONFIGS.md) |
140143
| WebRTC | SDP/ICE manipulation, candidate filtering | [ADVANCED_FEATURES#WebRTC Leak Protection](ADVANCED_FEATURES.md#webrtc-leak-protection) |
141144
| UA Congruence | Brand + full-version alignment | [CLI_FLAGS#Profile Configuration Override Flags](CLI_FLAGS.md#⚙️-profile-configuration-override-flags) |
142145
| UA Congruence | Brand + full-version alignment | [CLI_FLAGS#Profile Configuration Override Flags](CLI_FLAGS.md#profile-configuration-override-flags) |
146+
| Client Hints vs JS metrics | CH DPR/device-memory/UA-CH stay in lockstep with JavaScript-visible values | [ADVANCED_FEATURES#Browser & OS Fingerprinting](ADVANCED_FEATURES.md#browser--os-fingerprinting) |
143147
| Headless Parity | GPU/WebGPU/media signals stable | [ADVANCED_FEATURES#Headless & Incognito Compatibility](ADVANCED_FEATURES.md#headless-incognito-compatibility) |
144148
| DNS Leaks | SOCKS5 DNS-through-proxy | [ADVANCED_FEATURES#Enhanced Proxy System](ADVANCED_FEATURES.md#enhanced-proxy-system) |
145149
| HTTP Headers | Chrome-like headers, HTTP/2/3 behavior | [ADVANCED_FEATURES#Chrome Behavior Emulation](ADVANCED_FEATURES.md#chrome-behavior-emulation) |

profiles/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -175,6 +175,7 @@ chromium --no-sandbox \
175175
- [x] **Set language and timezone** based on proxy or manually
176176
- [x] **WebRTC configuration control**
177177
- [x] **Canvas / WebGL noise injection** for consistency
178+
- [x] **DOM text renders from embedded fonts** so cross-OS simulations never fall through to host font files
178179
- [x] **Audio fingerprinting variation**
179180
- [x] **Control scroll bar width**
180181
- [x] **Supports CDM compatibility** (no proprietary modules distributed)

0 commit comments

Comments
 (0)