mirror of
https://forge.fsky.io/oneflux/omegafox.git
synced 2026-02-10 12:42:03 -08:00
158 lines
4 KiB
Markdown
158 lines
4 KiB
Markdown
<div align="center">
|
|
|
|
# Camoufox Python Interface
|
|
|
|
#### Lightweight wrapper around the Playwright API to help launch Camoufox.
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
First, install the `camoufox` package:
|
|
|
|
```bash
|
|
pip install -U camoufox
|
|
```
|
|
|
|
Then, download the Camoufox browser:
|
|
|
|
**Windows**
|
|
|
|
```bash
|
|
camoufox fetch
|
|
```
|
|
|
|
**MacOS & Linux**
|
|
|
|
```bash
|
|
python3 -m camoufox fetch
|
|
```
|
|
|
|
To uninstall, run `camoufox remove`.
|
|
|
|
<details>
|
|
<summary>CLI options</summary>
|
|
|
|
```
|
|
Usage: python -m camoufox [OPTIONS] COMMAND [ARGS]...
|
|
|
|
Options:
|
|
--help Show this message and exit.
|
|
|
|
Commands:
|
|
fetch Fetch the latest version of Camoufox
|
|
remove Remove all downloaded files
|
|
test Open the Playwright inspector
|
|
version Display the current version
|
|
```
|
|
|
|
</details>
|
|
|
|
<hr width=50>
|
|
|
|
## Usage
|
|
|
|
Camoufox is fully compatible with your existing Playwright code. You only have to change your browser initialization:
|
|
|
|
#### Sync API
|
|
|
|
```python
|
|
from camoufox.sync_api import Camoufox
|
|
|
|
with Camoufox(headless=False) as browser:
|
|
page = browser.new_page()
|
|
page.goto("https://example.com/")
|
|
```
|
|
|
|
#### Async API
|
|
|
|
```python
|
|
from camoufox.async_api import AsyncCamoufox
|
|
|
|
async with AsyncCamoufox(headless=False) as browser:
|
|
page = await browser.new_page()
|
|
await page.goto("https://example.com")
|
|
```
|
|
|
|
<details>
|
|
<summary>Parameters</summary>
|
|
|
|
```
|
|
Launches a new browser instance for Camoufox.
|
|
Accepts all Playwright Firefox launch options, along with the following:
|
|
|
|
Parameters:
|
|
playwright (Playwright):
|
|
The playwright instance to use.
|
|
config (Optional[Dict[str, Any]]):
|
|
The configuration to use.
|
|
addons (Optional[List[str]]):
|
|
The addons to use.
|
|
fingerprint (Optional[Fingerprint]):
|
|
The fingerprint to use.
|
|
exclude_addons (Optional[List[DefaultAddons]]):
|
|
The default addons to exclude, passed as a list of camoufox.DefaultAddons enums.
|
|
screen (Optional[browserforge.fingerprints.Screen]):
|
|
The screen constraints to use.
|
|
os (Optional[ListOrString]):
|
|
The operating system to use for the fingerprint. Either a string or a list of strings.
|
|
user_agent (Optional[ListOrString]):
|
|
The user agent to use for the fingerprint. Either a string or a list of strings.
|
|
fonts (Optional[List[str]]):
|
|
The fonts to load into Camoufox, in addition to the default fonts.
|
|
args (Optional[List[str]]):
|
|
The arguments to pass to the browser.
|
|
executable_path (Optional[str]):
|
|
The path to the Camoufox browser executable.
|
|
**launch_options (Dict[str, Any]):
|
|
Additional Firefox launch options.
|
|
```
|
|
|
|
</details>
|
|
|
|
---
|
|
|
|
### Config
|
|
|
|
Camoufox [config data](https://github.com/daijro/camoufox?tab=readme-ov-file#fingerprint-injection) can be passed as a dictionary to the `config` parameter:
|
|
|
|
```python
|
|
from camoufox import Camoufox
|
|
|
|
with Camoufox(
|
|
config={
|
|
'webrtc:ipv4': '123.45.67.89',
|
|
'webrtc:ipv6': 'e791:d37a:88f6:48d1:2cad:2667:4582:1d6d',
|
|
}
|
|
) as browser:
|
|
page = browser.new_page()
|
|
page.goto("https://www.browserscan.net/webrtc")
|
|
```
|
|
|
|
<hr width=50>
|
|
|
|
### BrowserForge Integration
|
|
|
|
Camoufox is compatible with [BrowserForge](https://github.com/daijro/browserforge) fingerprints.
|
|
|
|
By default, Camoufox will use a random fingerprint. You can also inject your own Firefox Browserforge fingerprint into Camoufox with the following example:
|
|
|
|
```python
|
|
from camoufox.sync_api import Camoufox
|
|
from browserforge.fingerprints import FingerprintGenerator
|
|
|
|
fg = FingerprintGenerator(browser='firefox')
|
|
|
|
# Launch Camoufox with a random Firefox fingerprint
|
|
with Camoufox(fingerprint=fg.generate()) as browser:
|
|
page = browser.new_page()
|
|
page.goto("https://example.com/")
|
|
```
|
|
|
|
<hr width=50>
|
|
|
|
**Note:** As of now, some properties from BrowserForge fingerprints will not be passed to Camoufox. This is due to the outdated fingerprint dataset from Apify's fingerprint-suite (see [here](https://github.com/apify/fingerprint-suite/discussions/308)). Properties will be re-enabled as soon as an updated dataset is available.
|
|
|
|
---
|