https://github.com/lysagxra/hentaisaturndownloader
Efficient downloader for HentaiSaturn
https://github.com/lysagxra/hentaisaturndownloader
bulk bulk-downloader concurrent-processing downloader hanime hentai hentai-downloader parallel-processing python python3
Last synced: about 1 month ago
JSON representation
Efficient downloader for HentaiSaturn
- Host: GitHub
- URL: https://github.com/lysagxra/hentaisaturndownloader
- Owner: Lysagxra
- License: gpl-3.0
- Created: 2024-10-24T22:02:14.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-12-15T10:37:14.000Z (4 months ago)
- Last Synced: 2024-12-15T11:27:33.935Z (4 months ago)
- Topics: bulk, bulk-downloader, concurrent-processing, downloader, hanime, hentai, hentai-downloader, parallel-processing, python, python3
- Language: Python
- Homepage:
- Size: 1.93 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HentaiSaturn Downloader
> A Python-based tool for downloading hanime series from HentaiSaturn, featuring progress tracking for each episode. It efficiently extracts video URLs and manages downloads.
## Features
- Downloads multiple episodes concurrently.
- Supports batch downloading via a list of URLs.
- Tracks download progress with a progress bar.
- Supports downloading from alternative hosts if necessary.
- Automatically creates a directory structure for organized storage.
## Directory Structure
```
project-root/
├── helpers/
│ ├── download_utils.py # Utilities for managing the download process
│ ├── file_utils.py # Utilities for managing file operations
│ ├── format_utils.py # Utilities for processing and formatting strings or URLs
│ ├── general_utils.py # Miscellaneous utility functions
│ ├── progress_utils.py # Tools for progress tracking and reporting
│ └── streamtape_utils.py # Module for extracting download links from alternative host
├── hanime_downloader.py # Module for downloading hanime episodes
├── main.py # Main script to run the downloader
└── URLs.txt # Text file containing anime URLs
```
## Dependencies
- Python 3
- `requests` - for HTTP requests
- `BeautifulSoup` (bs4) - for HTML parsing
- `rich` - for progress display in terminal
## Installation
1. Clone the repository:
```bash
git clone https://github.com/Lysagxra/HentaiSaturnDownloader.git
```
3. Navigate to the project directory:
```bash
cd HentaiSaturnDownloader
```
3. Install the required dependencies:
```bash
pip install -r requirements.txt
```
## Single Hanime Download
To download a single hanime, you can use the `hanime_downloader.py` script.
### Usage
Run the script followed by the hanime URL you want to download:
```bash
python3 hanime_downloader.py
```
### Example
```
python3 hanime_downloader.py https://www.hentaisaturn.tv/hentai/Boku-ni-Harem-Sefure-ga-Dekita-Riyuu
```
## Batch Download
### Usage
1. Create a `URLs.txt` file in the project root and list the hanime URLs you want to download.
2. Run the main script via the command line:
```
python3 main.py
```
The downloaded files will be saved in the `Downloads` directory.