Metadata-Version: 2.4
Name: foxyz
Version: 1.2.0
Summary: Wrapper around Playwright to help launch Foxyz
License: MIT
Keywords: client,fingerprint,browser,scraping,injector,firefox,playwright
Author: AntifoxyzDev
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: gui
Requires-Dist: PySide6 ; extra == "gui"
Requires-Dist: browserforge (>=1.2.4,<2.0.0)
Requires-Dist: geoip2
Requires-Dist: inquirer
Requires-Dist: language-tags
Requires-Dist: lxml
Requires-Dist: numpy
Requires-Dist: orjson
Requires-Dist: platformdirs
Requires-Dist: playwright
Requires-Dist: pysocks
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: rich
Requires-Dist: rich-click
Requires-Dist: screeninfo
Requires-Dist: typing_extensions
Requires-Dist: ua_parser
Project-URL: Homepage, https://github.com/foxyzcoding/foxyz
Project-URL: Repository, https://github.com/foxyzcoding/foxyz
Description-Content-Type: text/markdown

<div align="center">

# Foxyz

#### Python library for launching and managing Foxyz browser profiles with unique, consistent fingerprints.

</div>

---

## Features

- Unique, consistent browser fingerprints across every session
- Automatic fingerprint generation — OS, CPU, screen, navigator, fonts, headers, WebGL, audio
- Runtime window resize with full fingerprint integrity (iW = oW at all sizes)
- Per-session WebGL hash randomization
- Geolocation, timezone, and locale matching for proxy environments
- Headful and headless modes
- Async and sync API

---

## Installation

```bash
pip install foxyz
foxyz fetch
```

---

## Quick Start

**Async:**

```python
from foxyz.async_api import AsyncFoxyz

async with AsyncFoxyz(headless=False, window=(1280, 800)) as browser:
    page = await browser.new_page()
    await page.goto("https://example.com")
```

**Sync:**

```python
from foxyz.sync_api import NewBrowser
from foxyz.utils import launch_options

opts = launch_options(headless=False, window=(1280, 800))
with NewBrowser(headless=False, from_options=opts) as browser:
    page = browser.new_page()
    page.goto("https://example.com")
```

---

## CLI

```bash
foxyz fetch          # Download the browser
foxyz fetch --help   # See all options
foxyz list           # List installed versions
foxyz remove         # Remove all data
foxyz version        # Show version info
```

---

## Requirements

- Python 3.10+
- macOS arm64 / x64, Windows x64, Linux x64

