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.

Features

• Downloads multiple files concurrently.
• Supports batch downloading 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:

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

2. Navigate to the project directory:

cd EHentaiDownloader

3. Install the required dependencies:

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

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.