Skip to content

Commit c822eeb

Browse files
committed
docs: reframe documentation as privacy protection
1 parent 69a772c commit c822eeb

28 files changed

Lines changed: 55 additions & 55 deletions

File tree

ADVANCED_FEATURES.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# BotBrowser Advanced Features
22

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.
44

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).
66

77
## 📘 Overview
88

@@ -154,7 +154,7 @@ chromium-browser --no-sandbox --bot-profile="/abs/profile.enc" \
154154
## 🔒 Privacy Protection & Fingerprint Randomization
155155

156156
### Multi Layer Fingerprint Noise
157-
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.
158158

159159
- **Canvas**: `--bot-config-noise-canvas=true`
160160
- **WebGL image**: `--bot-config-noise-webgl-image=true`
@@ -189,7 +189,7 @@ Consistent behavior across modes with comprehensive simulation.
189189
- Hardware-accelerated video decoding simulation
190190

191191
**Incognito‑Mode Enhancements:**
192-
- Eliminates incognito-specific detection vectors
192+
- Maintains fingerprint consistency in incognito mode
193193
- Consistent fingerprint between normal and incognito modes
194194
- Maintains privacy features while ensuring consistency
195195
- For CLI launch guidance, see README “Quick Start” and [`INSTALLATION.md`](INSTALLATION.md#headless)
@@ -523,7 +523,7 @@ chrome.exe --no-sandbox --bot-profile="C:\\absolute\\path\\to\\profile.enc" --bo
523523
Enhanced compatibility with popular automation frameworks.
524524

525525
**CDP‑Leak Protection:**
526-
- Blocks automation detection via Chrome DevTools Protocol artifacts
526+
- Prevents CDP artifacts from appearing in page context
527527
- Maintains authentic browser behavior under automation
528528
- Eliminates framework-specific fingerprint signatures
529529

@@ -542,7 +542,7 @@ BotBrowser’s capabilities support multiple research applications in authorized
542542
**Browser Compatibility Studies:**
543543
- Cross-platform rendering consistency analysis
544544
- Fingerprint stability across different environments
545-
- Automation detection mechanism research
545+
- Fingerprint consistency research
546546

547547
**Security Research:**
548548
- Web application security testing

CHANGELOG.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
- **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.
1818

1919
### 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.
2121
- **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.
2222

2323
### Improvements
@@ -41,7 +41,7 @@
4141

4242
### Fixes
4343
- **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.
4545

4646

4747
## [2025-12-03]
@@ -96,7 +96,7 @@
9696
### New
9797
- **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.
9898

99-
Example (Edge spoofing):
99+
Example (Edge browser emulation):
100100
```bash
101101
--bot-config-browser-brand=edge \ # PRO feature
102102
--bot-config-ua-full-version=142.0.7444.135 \ # PRO feature
@@ -119,7 +119,7 @@ Example (Edge spoofing):
119119

120120
## [2025-11-10]
121121
### 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.
123123

124124
### New
125125
- **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):
130130
- **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.
131131

132132
### 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 cant 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.
134134
- **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.
135135
- **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.
136136

@@ -259,7 +259,7 @@ Example (Edge spoofing):
259259
- Hardened preload path and timing so this stock component extension reliably appears; improves **Chrome‑authentic** signals that some scanners expect.
260260

261261
- **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/
263263

264264
- **Media types default → `expand`**
265265
- `--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):
399399
## [2025-09-06]
400400
### Major
401401
- **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.
403403
404404
### Improved
405405
- **Slimmer Profiles (≈1.3 MB → ≈100 KB)**

CLI_FLAGS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
For Academic and Authorized Testing Environments.
44

5-
This document explains BotBrowsers 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).
66

77
> Smart auto‑configuration: BotBrowser derives timezone, locale, and languages from your IP/proxy. Override only when you need a specific setup.
88

DISCLAIMER.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ The following uses are strictly prohibited:
5454
- Circumventing security controls on production systems
5555
- Data harvesting or privacy violations
5656
- Automated abuse of web services
57-
- Bypassing automated detection measures for malicious purposes
57+
- Circumventing fraud prevention systems or security controls
5858
- Any use that violates local, state, federal, or international laws
5959

6060
## PROHIBITED USES - SPECIFIC EXAMPLES
@@ -70,9 +70,9 @@ The following uses are strictly prohibited:
7070
- **PROHIBITED:** Automated account creation against ToS
7171

7272
**Ticketing & Event Systems:**
73-
- **PROHIBITED:** Automated ticket purchasing, queue bypassing, or inventory hoarding
73+
- **PROHIBITED:** Automated ticket purchasing or queue bypassing that reduce fair access
7474
- **PROHIBITED:** Testing production ticketing flows without written authorization from the event operator
75-
- **PROHIBITED:** Using BotBrowser to conduct or facilitate ticket scalping activities
75+
- **PROHIBITED:** Using BotBrowser for ticket scalping that harms consumers
7676

7777
**Data Harvesting:**
7878
- **PROHIBITED:** Scraping personal information

INSTALLATION.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -271,4 +271,4 @@ When reporting installation problems, please include:
271271

272272
---
273273

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.

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<h4 align="center">Advanced Privacy Browser Core with Unified Fingerprint Defense 🚀</h4>
44

55
<p align="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
77
</p>
88

99
<p align="center">
@@ -31,15 +31,15 @@
3131
---
3232
## 📖 What Is BotBrowser?
3333

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.
3535

3636
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.
3737

3838
---
3939

4040
## 🏆 Why BotBrowser
4141

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.
4343
4444
<table cellspacing="0" cellpadding="8">
4545
<tr>
@@ -192,7 +192,7 @@ Prefer a GUI launcher? See [console/README.md](console) for BotBrowserConsole us
192192

193193
### Research Methodology
194194

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.
196196

197197
> ⚠️ Research validation uses authorized test environments. See [DISCLAIMER](DISCLAIMER.md).
198198

VALIDATION.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Fingerprint Consistency Validation Across Platforms and Deployment Scenarios.
44

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.
66

77
---
88

@@ -11,10 +11,10 @@ Research data demonstrating how BotBrowser maintains standardized fingerprints f
1111
We validate fingerprint consistency across platforms and scenarios using repeatable scientific testing.
1212

1313
### 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?
1515
- 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?
1818

1919
### Validation Infrastructure
2020
- Multiple operating systems (Windows, macOS, Linux)
@@ -26,9 +26,9 @@ We validate fingerprint consistency across platforms and scenarios using repeata
2626

2727
## 📊 Research Results
2828

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.
3030
>
31-
> ⚠️ **Synthetic Data:** All tests use synthetic or non-existent data (random usernames, invalid identifiers). No real user data or 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.
3232
>
3333
> ⚠️ **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.
3434
>

build/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,4 +31,4 @@
3131

3232
---
3333

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.

console/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,4 +78,4 @@ For research-related collaboration or licensing review, please contact us:
7878

7979
---
8080

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.

docker/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
For Academic and Authorized Testing Environments. Refer to the project [Legal Disclaimer](../DISCLAIMER.md) and [Responsible Use Guidelines](../RESPONSIBLE_USE.md) when deploying containers.
44

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.
66

77
---
88

0 commit comments

Comments
 (0)