You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: ADVANCED_FEATURES.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
1
# BotBrowser Advanced Features
2
2
3
-
Comprehensive technical controls for fingerprint consistency and privacy-focused research automation.
3
+
Comprehensive technical controls for fingerprint consistency that prevent tracking systems from collecting user identification data.
4
4
5
-
Use this document when you need detailed technical reference behind the [README](README.md): implementation strategies, fingerprint consistency controls, and privacy protection mechanisms that don't fit on the main page. Each section links back to the relevant quick-start guide (CLI flags, README, validation data) so you can jump between overview and implementation details quickly. For overall usage terms, refer to the [Legal Disclaimer](DISCLAIMER.md) and [Responsible Use Guidelines](RESPONSIBLE_USE.md).
5
+
Use this document for detailed technical reference behind the [README](README.md): implementation strategies for preventing fingerprint collection, consistency controls, and privacy protection mechanisms not on the main page. Each section links back to the relevant quick-start guide (CLI flags, README, validation data) so you can jump between overview and implementation details quickly. For overall usage terms, refer to the [Legal Disclaimer](DISCLAIMER.md) and [Responsible Use Guidelines](RESPONSIBLE_USE.md).
Deterministic noise generation prevents fingerprint reproducibility. Configure all settings through CLI without modifying encrypted profiles.
157
+
Deterministic noise generation prevents fingerprint collection and reproducibility. Configure all settings through CLI without modifying encrypted profiles.
Copy file name to clipboardExpand all lines: CHANGELOG.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@
17
17
-**Chromium Core → 143.0.7499.147**: Updated the engine to 143.0.7499.147 to stay aligned with the latest Chrome Stable. This keeps Web Platform behavior, DevTools schemas, and version keyed heuristics in lockstep with upstream.
18
18
19
19
### New
20
-
-**Local DNS solver (ENT Tier1)**: Added a local DNS resolver that can be enabled with `--bot-local-dns`. This improves privacy and resolution speed, avoids common DNS poisoning scenarios, and bypasses DNS limitations imposed by some proxy providers.
20
+
-**Local DNS solver (ENT Tier1)**: Added a local DNS resolver that can be enabled with `--bot-local-dns`. This improves privacy and resolution speed, avoids common DNS poisoning scenarios, and manages DNS resolution for proxy compatibility.
21
21
-**Custom public IP service**: Added `--bot-ip-service` so you can point BotBrowser at your own IP lookup endpoint when you want full control over how the public egress IP is detected. Multiple endpoints can be provided as a comma-separated list, and BotBrowser will race them and use the fastest successful response.
22
22
23
23
### Improvements
@@ -41,7 +41,7 @@
41
41
42
42
### Fixes
43
43
-**Pixelscan WebGL noise**: Refined WebGL canvas noise so <http://pixelscan.net> no longer flags the fraud heuristics triggered by earlier, coarse noise injection; multi-pass renders now inherit the same noise field as the base frame.
44
-
-**Client Hints DPR parity**: `sec-ch-dpr` now matches `window.devicePixelRatio`, eliminating mismatches between Client Hints metadata and JS-observable values, which removes a quick heuristic some anti-bot flows used to detect spoofed DPIs.
44
+
-**Client Hints DPR parity**: `sec-ch-dpr` now matches `window.devicePixelRatio`, eliminating mismatches between Client Hints metadata and JS-observable values, ensuring consistency across detection systems.
45
45
46
46
47
47
## [2025-12-03]
@@ -96,7 +96,7 @@
96
96
### New
97
97
-**Brand full‑version override**: `--bot-config-brand-full-version` sets the brand’s full version independently of the UA full version. Helpful where a vendor’s cadence diverges from Chromium and sites cross‑check UA‑CH with brand metadata.
98
98
99
-
Example (Edge spoofing):
99
+
Example (Edge browser emulation):
100
100
```bash
101
101
--bot-config-browser-brand=edge \ # PRO feature
102
102
--bot-config-ua-full-version=142.0.7444.135 \ # PRO feature
@@ -119,7 +119,7 @@ Example (Edge spoofing):
119
119
120
120
## [2025-11-10]
121
121
### Major
122
-
-**Chromium 142.0.7444.135 parity**: Synced core to the latest Chrome 142 stable build for up‑to‑date security patches, modern Web APIs, and version parity that reduces “version skew” signals used by anti‑bot systems.
122
+
-**Chromium 142.0.7444.135 parity**: Synced core to the latest Chrome 142 stable build for up‑to‑date security patches, modern Web APIs, and version parity that keeps Web Platform behavior consistent with upstream.
123
123
124
124
### New
125
125
-**Locked user data directory protection**: On startup, if the provided `--user-data-dir` is already held by a running Chromium/BotBrowser process, BotBrowser now **shows a clear message and exits** instead of silently attaching to the old process. This prevents cross‑session contamination (cookies, storage, profile state) and hard‑to‑trace side‑effects.
@@ -130,7 +130,7 @@ Example (Edge spoofing):
130
130
-**Touch events in OOPIF**: Improved routing of emulated touch gestures for **Out‑Of‑Process IFrames (OOPIF)**, ensuring CDP commands like `Input.synthesizeTapGesture` work reliably inside OOPIF trees. Mobile flows embedded in cross‑origin iframes now respond as expected.
131
131
132
132
### Fixes
133
-
-**Ubuntu Bluetooth spoof leakage**: Fixed a Linux/Ubuntu‑specific issue where forged Bluetooth properties could leak inconsistent state. Spoofed Bluetooth exposure is now unified so websites can’t infer environment details from mismatched availability/signaling.
133
+
-**Ubuntu Bluetooth emulation leakage**: Fixed a Linux/Ubuntu‑specific issue where emulated Bluetooth properties could leak inconsistent state. Bluetooth emulation exposure is now unified so websites can't infer environment details from mismatched availability/signaling.
134
134
-**Media types (expand) default**: Resolved an issue where `--bot-config-media-types=expand` (and the default behavior) could be ignored in some scenarios. With this fix, local decoders are correctly surfaced so users can **select resolutions** on major video sites.
135
135
-**WebRTC SDP negotiation**: Corrected edge cases where SDP **audio codec selection or direction attributes** failed to negotiate. More robust media negotiation prevents call/setup loops and reduces fingerprinting surface from abnormal SDP.
136
136
@@ -259,7 +259,7 @@ Example (Edge spoofing):
259
259
- Hardened preload path and timing so this stock component extension reliably appears; improves **Chrome‑authentic** signals that some scanners expect.
260
260
261
261
- **WebGL/WebGL2 parameter reads**
262
-
- Reworked parameter access to avoid **application‑settable states** and cross‑driver quirks; prevents false values and closes detection patterns reported by https://fv.pro/
262
+
- Reworked parameter access to avoid **application‑settable states** and cross‑driver quirks; prevents false values and improves compatibility across platforms reported by https://fv.pro/
263
263
264
264
- **Media types default → `expand`**
265
265
- `--bot-config-media-types` now defaults to **`expand`** (previously `profile`) so BotBrowser leverages **local decoders** by default → more accurate `canPlayType`/MSE decisions.
@@ -399,7 +399,7 @@ Example (Edge spoofing):
399
399
## [2025-09-06]
400
400
### Major
401
401
- **Chromium Core Upgrade → 140**
402
-
Upgraded engine to Chromium **140** to maintain Chrome‑level parity and stealth consistency across APIs and anti‑bot surfaces.
402
+
Upgraded engine to Chromium **140** to maintain Chrome‑level parity and fingerprint consistency across APIs and fingerprinting surfaces.
Copy file name to clipboardExpand all lines: CLI_FLAGS.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
For Academic and Authorized Testing Environments.
4
4
5
-
This document explains BotBrowser’s CLI configuration system. These flags extend Chromium and provide comprehensive, runtime control over fingerprints without modifying profile files. For terms of use, see the [Legal Disclaimer](DISCLAIMER.md) and [Responsible Use Guidelines](RESPONSIBLE_USE.md).
5
+
This document explains BotBrowser's CLI configuration system. These flags extend Chromium and provide runtime control over fingerprints to prevent tracking system collection without modifying profile files. For terms of use, see the [Legal Disclaimer](DISCLAIMER.md) and [Responsible Use Guidelines](RESPONSIBLE_USE.md).
6
6
7
7
> Smart auto‑configuration: BotBrowser derives timezone, locale, and languages from your IP/proxy. Override only when you need a specific setup.
Copy file name to clipboardExpand all lines: INSTALLATION.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -271,4 +271,4 @@ When reporting installation problems, please include:
271
271
272
272
---
273
273
274
-
**📋 [Legal Disclaimer & Terms of Use](https://github.com/botswin/BotBrowser/blob/main/DISCLAIMER.md)** • **[Responsible Use Guidelines](https://github.com/botswin/BotBrowser/blob/main/RESPONSIBLE_USE.md)**. BotBrowser is for authorized fingerprint-consistency testing and research only.
274
+
**📋 [Legal Disclaimer & Terms of Use](https://github.com/botswin/BotBrowser/blob/main/DISCLAIMER.md)** • **[Responsible Use Guidelines](https://github.com/botswin/BotBrowser/blob/main/RESPONSIBLE_USE.md)**. BotBrowser is for authorized fingerprint protection and privacy research only.
Copy file name to clipboardExpand all lines: README.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@
3
3
<h4align="center">Advanced Privacy Browser Core with Unified Fingerprint Defense 🚀</h4>
4
4
5
5
<palign="center">
6
-
Identical privacy posture on any OS • Cross-platform compatibility • Fingerprint consistency validated across 31+ detection scenarios
6
+
Identical privacy posture on any OS • Cross-platform compatibility • Fingerprint consistency validated across 31+ fingerprinting scenarios
7
7
</p>
8
8
9
9
<palign="center">
@@ -31,15 +31,15 @@
31
31
---
32
32
## 📖 What Is BotBrowser?
33
33
34
-
BotBrowser is a privacy first browser core that keeps fingerprint signals uniform across every platform so hostile trackers cannot build per-machine dossiers. Run the same profile on Windows, macOS, or Linux and the fingerprint posture stays identical each time.
34
+
BotBrowser is a privacy first browser core that keeps fingerprint signals uniform across every platform, preventing tracking systems from collecting and correlating fingerprints to identify users across devices. Run the same profile on Windows, macOS, or Linux and the fingerprint posture stays identical each time.
35
35
36
36
All engineering focuses on automation-assisted privacy research, cross-platform tracking-resistance validation, and maintaining consistent environments for authorized defensive benchmarking. Review the project [Legal Disclaimer](DISCLAIMER.md) and [Responsible Use Guidelines](RESPONSIBLE_USE.md) before using the software.
37
37
38
38
---
39
39
40
40
## 🏆 Why BotBrowser
41
41
42
-
> **What makes BotBrowser different:** Cross-platform privacy browser core with unified fingerprint technology that stops fingerprint drift everywhere.
42
+
> **What makes BotBrowser different:** Cross-platform privacy browser core with unified fingerprint technology that prevents fingerprint collection and device linkage.
43
43
44
44
<tablecellspacing="0"cellpadding="8">
45
45
<tr>
@@ -192,7 +192,7 @@ Prefer a GUI launcher? See [console/README.md](console) for BotBrowserConsole us
192
192
193
193
### Research Methodology
194
194
195
-
Our fingerprint consistency research examines how standardized browser fingerprints protect users from cross-platform tracking and identification. By maintaining identical fingerprints across operating systems, we demonstrate how privacy protection through consistency prevents the tracking methods that malicious observers rely on.
195
+
Our fingerprint consistency research examines how standardized browser fingerprints prevent tracking systems from collecting fingerprint data to identify users across platforms. By maintaining identical fingerprints across operating systems, we demonstrate how privacy protection through consistency prevents the tracking methods that malicious observers rely on.
196
196
197
197
> ⚠️ Research validation uses authorized test environments. See [DISCLAIMER](DISCLAIMER.md).
Copy file name to clipboardExpand all lines: VALIDATION.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
Fingerprint Consistency Validation Across Platforms and Deployment Scenarios.
4
4
5
-
Research data demonstrating how BotBrowser maintains standardized fingerprints for privacy protection across real-world deployment contexts.
5
+
Research data demonstrating how BotBrowser prevents tracking systems from collecting and correlating fingerprints across real-world deployment contexts.
6
6
7
7
---
8
8
@@ -11,10 +11,10 @@ Research data demonstrating how BotBrowser maintains standardized fingerprints f
11
11
We validate fingerprint consistency across platforms and scenarios using repeatable scientific testing.
12
12
13
13
### What We Validate
14
-
- Same profile on Windows, macOS, and Linux: does it maintain identical fingerprints?
14
+
- Same profile on Windows, macOS, and Linux: can it prevent fingerprint collection across platforms?
15
15
- Mobile profiles on desktop: do they simulate realistic mobile APIs?
16
-
- Long-term stability: do fingerprints remain consistent over repeated sessions?
17
-
- Deployment scenarios: how effectively does BotBrowser preserve privacy in real-world environments?
16
+
- Long-term stability: do fingerprints prevent cross-session user identification?
17
+
- Deployment scenarios: how effectively does BotBrowser prevent fingerprint-based user tracking?
18
18
19
19
### Validation Infrastructure
20
20
- Multiple operating systems (Windows, macOS, Linux)
@@ -26,9 +26,9 @@ We validate fingerprint consistency across platforms and scenarios using repeata
26
26
27
27
## 📊 Research Results
28
28
29
-
> ⚠️ **Authorization & Compliance:** All research validation occurs in authorized test environments with explicit approval. Not intended for unauthorized access or production system testing. All validation was conducted with proper authorization agreements.
29
+
> ⚠️ **Authorization & Compliance:** All research validation occurs in authorized test environments with explicit approval. This research prevents fingerprint collection for privacy, not unauthorized access. All validation was conducted with proper authorization agreements.
30
30
>
31
-
> ⚠️ **Synthetic Data:** All tests use synthetic or non-existent data (random usernames, invalid identifiers). No real user dataor valid credentials are involved in any validation.
31
+
> ⚠️ **Synthetic Data:** All tests use synthetic or non-existent data (random usernames, invalid identifiers). No real user data, credentials, or tracking information is collected in validation.
32
32
>
33
33
> ⚠️ **Service Provider Testing:** Tests involving financial services or branded platforms execute only against authorized demo environments or documented test endpoints. Production validation requires written authorization from the service provider.
Copy file name to clipboardExpand all lines: build/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,4 +31,4 @@
31
31
32
32
---
33
33
34
-
**📋 [Legal Disclaimer & Terms of Use](https://github.com/botswin/BotBrowser/blob/main/DISCLAIMER.md)** • **[Responsible Use Guidelines](https://github.com/botswin/BotBrowser/blob/main/RESPONSIBLE_USE.md)**. BotBrowser is for authorized fingerprint-consistency testing and research only.
34
+
**📋 [Legal Disclaimer & Terms of Use](https://github.com/botswin/BotBrowser/blob/main/DISCLAIMER.md)** • **[Responsible Use Guidelines](https://github.com/botswin/BotBrowser/blob/main/RESPONSIBLE_USE.md)**. BotBrowser is for authorized fingerprint protection and privacy research only.
Copy file name to clipboardExpand all lines: console/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -78,4 +78,4 @@ For research-related collaboration or licensing review, please contact us:
78
78
79
79
---
80
80
81
-
**📋 [Legal Disclaimer & Terms of Use](https://github.com/botswin/BotBrowser/blob/main/DISCLAIMER.md)** • **[Responsible Use Guidelines](https://github.com/botswin/BotBrowser/blob/main/RESPONSIBLE_USE.md)**. BotBrowser is for authorized fingerprint-consistency testing and research only.
81
+
**📋 [Legal Disclaimer & Terms of Use](https://github.com/botswin/BotBrowser/blob/main/DISCLAIMER.md)** • **[Responsible Use Guidelines](https://github.com/botswin/BotBrowser/blob/main/RESPONSIBLE_USE.md)**. BotBrowser is for authorized fingerprint protection and privacy research only.
Copy file name to clipboardExpand all lines: docker/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
For Academic and Authorized Testing Environments. Refer to the project [Legal Disclaimer](../DISCLAIMER.md) and [Responsible Use Guidelines](../RESPONSIBLE_USE.md) when deploying containers.
4
4
5
-
This guide explains how to deploy BotBrowser using Docker and Docker Compose in authorized research setups.
5
+
This guide explains how to deploy BotBrowser using Docker and Docker Compose for authorized fingerprint protection validation.
0 commit comments