AnimeSaturn Downloader

A Python-based tool for downloading anime series from AnimeSaturn, 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
├── anime_downloader.py    # Module for downloading anime 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:

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

2. Navigate to the project directory:

cd AnimeSaturnDownloader

3. Install the required dependencies:

pip install -r requirements.txt

Single Anime Download

To download a single anime, you can use the anime_downloader.py script.

Usage

Run the script followed by the anime URL you want to download:

python3 anime_downloader.py <anime_url>

Example

python3 anime_downloader.py https://www.animesaturn.cx/anime/Dan-Da-Dan

Batch Download

Usage

1. Create a URLs.txt file in the project root and list the anime 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.