Skip to content

Commit

Permalink
Update README & bump to beta.7
Browse files Browse the repository at this point in the history
  • Loading branch information
daijro committed Sep 23, 2024
1 parent 8385561 commit a6aeb19
Show file tree
Hide file tree
Showing 2 changed files with 35 additions and 10 deletions.
43 changes: 34 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,15 @@ Camoufox aims to be a minimalistic browser for robust fingerprint injection & an
## Features

- Fingerprint injection (override properties of `navigator`, `window`, `screen`, etc) ✅
- Patches to avoid bot detection ✅
- Custom Playwright Juggler implementation for the latest Firefox ✅
- Font spoofing & anti-fingerprinting ✅
- WebRTC IP spoofing ✅
- Debloated & optimized for memory and speed ✅
- [PyPi package](https://pypi.org/project/camoufox/) for updates & unique fingerprint injection 📦
- Invisible to **all major anti-bot systems** 🎭
- Fingerprint injection (without JS injection!) ✅
- Override properties for device, viewport, screen, navigator, etc. ✅
- Font spoofing & anti-fingerprinting ✅
- WebRTC IP spoofing ✅
- Geolocation & timezone spoofing ✅
- Blocks & circumvents ads 🛡️
- Debloated & optimized for memory and speed 🚀
- [PyPi package](https://pypi.org/project/camoufox/) for updates & fingerprint rotation 📦
- Stays up to date with the latest Firefox version 🕓

## Sponsors
Expand Down Expand Up @@ -64,8 +66,7 @@ Camoufox is built on top of Firefox/Juggler instead of Chromium because:
### What's planned?

- Continue research on potential leaks
- ~~Create a PyPi package for downloading & updating Camoufox~~
- ~~Integrate [BrowserForge](https://github.com/daijro/browserforge) for fingerprint generation~~
- Integrate into [hrequests](https://github.com/daijro/hrequests)
- Built in TLS fingerprinting protection using [Hazetunnel](https://github.com/daijro/hazetunnel)
- Create integration tests
- Chromium port (long term)
Expand Down Expand Up @@ -259,6 +260,26 @@ Camoufox can override the following network headers:

</details>

<details>
<summary>
Geolocation
</summary>

| Property | Status | Description |
| --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| geolocation:latitude || Latitude to use. Requires `geolocation:longitude` to be set as well. |
| geolocation:longitude || Longitude to use. Requires `geolocation:longitude` to be set as well. |
| geolocation:accuracy || Accuracy in meters. This will be calculated automatically using the decminal percision of `geolocation:latitude` & `geolocation:longitude` if not set. |
| timezone || Set a custom TZ timezone (e.g. "America/Chicago"). This will also change `Date()` to return the local time. |
**Notes:**
- Setting `geolocation:latitude` & `geolocation:longitude` will automatically accept Location permission prompts.
- `timezone` **must** be set to a valid TZ identifier. See [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for a list of valid timezones.
- To change your locale, set the `intl.accept_languages` preference.
</details>
<details>
<summary>
WebRTC IP
Expand Down Expand Up @@ -338,6 +359,7 @@ Miscellaneous (WebGl spoofing, battery status, etc)
- Support for spoofing both inner and outer window viewport sizes
- Network headers (Accept-Languages and User-Agent) are spoofed to match the navigator properties
- WebRTC IP spoofing at the protocol level
- Geolocation & timezone spoofing
- etc.
#### Anti font fingerprinting
Expand Down Expand Up @@ -380,6 +402,9 @@ Miscellaneous (WebGl spoofing, battery status, etc)
## Stealth Performance
In Camoufox, all of Playwright's internal Page Agent Javascript is sandboxed and isolated.
This makes it **impossible** for a page to detect the presence of Playwright through Javascript inspection.
### Tests
Camoufox performs well against every major WAF I've tested. (Original test sites from [Botright](https://github.com/Vinyzu/botright/?tab=readme-ov-file#browser-stealth))
Expand Down
2 changes: 1 addition & 1 deletion upstream.sh
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
version=130.0.1
release=beta.6
release=beta.7

0 comments on commit a6aeb19

Please sign in to comment.