Metadata-Version: 2.4
Name: hbrowser
Version: 0.10.11
Summary: A tool for browsing tasks on e-h/exh-websites.
Author: Kuan-Lun Wang
License: GNU Affero General Public License v3
Project-URL: Homepage, https://github.com/Kuan-Lun/hbrowser
Project-URL: Tracker, https://github.com/Kuan-Lun/hbrowser/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: webdriver-manager>=4.0.2
Requires-Dist: fake-useragent>=2.2.0
Requires-Dist: h2h-galleryinfo-parser>=0.2.2
Requires-Dist: selenium>=4.35.0
Requires-Dist: beautifulsoup4>=4.13.4
Requires-Dist: hv-bie>=0.3.5
Requires-Dist: numpy>=2.2.6
Requires-Dist: opencv-python>=4.12.0.88
Requires-Dist: 2captcha-python>=2.0.2
Requires-Dist: undetected-chromedriver>=3.5.5
Dynamic: license-file

# HBrowser (hbrowser)

## Setup

### Environment Variables

HBrowser requires the following environment variable to handle Cloudflare verification challenges:

- `APIKEY_2CAPTCHA`: Your 2Captcha API key for solving CAPTCHA challenges

Set the environment variable before running the script:

**Bash/Zsh:**
```bash
export APIKEY_2CAPTCHA=your_api_key_here
```

**Fish:**
```fish
set -x APIKEY_2CAPTCHA your_api_key_here
```

**Windows Command Prompt:**
```cmd
set APIKEY_2CAPTCHA=your_api_key_here
```

**Windows PowerShell:**
```powershell
$env:APIKEY_2CAPTCHA="your_api_key_here"
```

HBrowser uses [2Captcha](https://2captcha.com/) service to automatically solve Cloudflare Turnstile and managed challenges that may appear during login. You need to register for a 2Captcha account and obtain an API key.

## Usage

Here's a quick example of how to use HBrowser:

```python
from hbrowser import EHDriver


if __name__ == "__main__":
    with EHDriver(**driverpass.getdict()) as driver:
        driver.punchin()
```

Here's a quick example of how to use HVBrowser:

```python
from hvbrowser import HVDriver


if __name__ == "__main__":
    with HVDriver() as driver:
        driver.monstercheck()
```
