hbrowser 0.26.0

A tool for browsing tasks on e-h/exh-websites.

HBrowser (hbrowser)

Setup

Tor Proxy (Optional)

HBrowser can route all traffic through the Tor network for IP privacy. If Tor Browser is installed, HBrowser will automatically detect and use it. To install:

1. Download and install from https://www.torproject.org/download/
2. HBrowser will automatically locate the tor binary from the default installation path:
   • macOS: /Applications/Tor Browser.app/Contents/MacOS/Tor/tor
   • Linux: /usr/bin/tor
   • Windows: Searches common installation paths (Desktop, AppData, Program Files)
3. If Tor Browser is not installed, HBrowser will use a direct connection instead.
4. To force disable Tor even when installed, set USE_TOR=0.
5. If your Tor Browser is installed in a non-standard location, set the TOR_BINARY_PATH environment variable.

Environment Variables

HBrowser requires the following environment variables:

• EH_USERNAME: Your E-Hentai account username
• EH_PASSWORD: Your E-Hentai account password
• APIKEY_2CAPTCHA: Your 2Captcha API key for solving CAPTCHA challenges
• HBROWSER_LOG_LEVEL (optional): Control logging verbosity (DEBUG, INFO, WARNING, ERROR). Default: INFO
• USE_TOR (optional): Set to 0 to disable Tor proxy even when Tor Browser is installed. Default: auto-detect
• TOR_BINARY_PATH (optional): Custom path to the tor binary if not installed in the default location

Set the environment variables before running the script:

Bash/Zsh:

export EH_USERNAME=your_username
export EH_PASSWORD=your_password
export APIKEY_2CAPTCHA=your_api_key_here
export HBROWSER_LOG_LEVEL=INFO          # Optional
export USE_TOR=0                        # Optional: disable Tor proxy
export TOR_BINARY_PATH=/path/to/tor     # Optional: custom tor path

Fish:

set -x EH_USERNAME your_username
set -x EH_PASSWORD your_password
set -x APIKEY_2CAPTCHA your_api_key_here
set -x HBROWSER_LOG_LEVEL INFO          # Optional
set -x USE_TOR 0                        # Optional: disable Tor proxy
set -x TOR_BINARY_PATH /path/to/tor     # Optional: custom tor path

Windows Command Prompt:

set EH_USERNAME=your_username
set EH_PASSWORD=your_password
set APIKEY_2CAPTCHA=your_api_key_here
set HBROWSER_LOG_LEVEL=INFO
set USE_TOR=0
set TOR_BINARY_PATH=C:\path\to\tor.exe

Windows PowerShell:

$env:EH_USERNAME="your_username"
$env:EH_PASSWORD="your_password"
$env:APIKEY_2CAPTCHA="your_api_key_here"
$env:HBROWSER_LOG_LEVEL="INFO"
$env:USE_TOR="0"
$env:TOR_BINARY_PATH="C:\path\to\tor.exe"

HBrowser uses 2Captcha 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.

Logging

HBrowser uses Python's built-in logging module. You can control the log level using the HBROWSER_LOG_LEVEL environment variable:

• DEBUG: Detailed information for diagnosing problems (most verbose)
• INFO: Confirmation that things are working as expected (default)
• WARNING: Something unexpected happened, but the software is still working
• ERROR: A serious problem that prevented a function from executing

Example:

# Set log level to DEBUG for detailed output
export HBROWSER_LOG_LEVEL=DEBUG
python your_script.py

# Set log level to WARNING to see only warnings and errors
export HBROWSER_LOG_LEVEL=WARNING
python your_script.py

Usage

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

from hbrowser import EHDriver


if __name__ == "__main__":
    with EHDriver() as driver:
        driver.punchin()

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

from hvbrowser import HVDriver


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