Metadata-Version: 2.4
Name: ehentaix
Version: 0.1.2
Summary: A Python library for downloading and searching E-Hentai albums
Author: originalFactor
License: MIT
Project-URL: Homepage, https://github.com/originalFactor/EhDownloaderLib
Project-URL: Repository, https://github.com/originalFactor/EhDownloaderLib
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: beautifulsoup4>=4.13.4
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0
Dynamic: license-file

# E-Hentai Downloader

> A Python-based tool for downloading E-Hentai albums. This tool reads a list of URLs from a file and processes the downloads accordingly.

![Demo](https://github.com/Lysagxra/EHentaiDownloader/blob/e6e408181db6bb6707c29135c7fd04b4859830d5/misc/Demo.gif)

## Features

- Downloads multiple files concurrently.
- Supports [batch downloading](https://github.com/Lysagxra/EHentaiDownloader/tree/main?tab=readme-ov-file#batch-download) via a list of URLs.
- Tracks download progress with a progress bar.
- Automatically creates a directory structure for organized storage.

## Dependencies

- Python 3
- `BeautifulSoup` (bs4) - for HTML parsing
- `fake_useragent` - for generating fake user agents for web scraping
- `requests` - for HTTP requests
- `rich` - for progress display in the terminal

## Directory Structure

```
project-root/
├── src/
│ ├── crawlers/
│ │ ├── crawler.py           # Main crawler module used across the project
│ │ └── crawler_utils.py     # Utilities for extracting media download links
│ ├── downloaders/
│ │ ├── album_downloader.py  # Manages the downloading of entire albums
│ │ └── download_utils.py    # Utilities for managing the download process
│ ├── managers/
│ │ ├── live_manager.py      # Manages a real-time live display
│ │ ├── log_manager.py       # Manages real-time log updates
│ │ └── progress_manager.py  # Manages progress bars
│ ├── config.py              # Manages constants and settings used across the project
│ ├── file_utils.py          # Utilities for managing file operations
│ └── general_utils.py       # Miscellaneous utility functions
├── downloader.py            # Module for initiating downloads from specified EHentai URLs
├── main.py                  # Main script to run the downloader
├── URLs.txt                 # Text file listing album URLs to be downloaded
└── session_log.txt          # Log file for recording session details
```

## Installation

1. Clone the repository:

```bash
git clone https://github.com/Lysagxra/EHentaiDownloader.git
```

2. Navigate to the project directory:

```bash
cd EHentaiDownloader
```

3. Install the required dependencies:

```bash
pip install -r requirements.txt
```

## Single Album Download

To download a single album from an URL, you can use `downloader.py`, running the script with a valid album URL.

### Usage

```bash
python3 downloader.py <album_url>
```

### Example

```
python3 downloader.py https://e-hentai.org/g/3392858/1a77348e16/
```

## Batch Download

To batch download from multiple album URLs, you can use the `main.py` script. This script reads URLs from a file named `URLs.txt` and downloads each one using the album downloader.

### Usage

1. Create a file named `URLs.txt` in the root of your project, listing each URL on a new line.

- Example of `URLs.txt`:

```
https://e-hentai.org/g/2466603/ab9b9e04c9/
https://e-hentai.org/g/2486673/e24cf9d5d8/
https://e-hentai.org/g/2490534/e80e7c554c/
```

- Ensure that each URL is on its own line without any extra spaces.
- You can add as many URLs as you need, following the same format.

2. Run the batch download script:

```
python3 main.py
```

3. The downloaded files will be saved in the `Downloads` directory.

## Logging

The application logs any issues encountered during the download process in a file named `session_log.txt`. Check this file for any URLs that may have been blocked or had errors.
