AnimeSaturn-API is an unofficial, modern, and high-performance Python package for searching, extracting metadata, and downloading anime from AnimeSaturn and all its official mirrors.
Built to provide the same ease of use and clean architecture as AnimeWorld-API.
Read this in:
Features
- 🔍 Instant Search: Direct query through AnimeSaturn's fast JSON search endpoint.
- 🌐 Multi-Domain & Official Mirrors: Auto-discovers and resolves working mirrors via
https://www.animesaturn.me/(animesaturn.net,animesaturn.tv,animesaturn.in, etc.). - 📑 Comprehensive Metadata: Title, Romaji/alternate name, plot, genres, season, language, rating, MAL/AniList links, cover image.
- 🔓 SaturnCDN Video Decryption: Built-in pure Python XOR decryption for SaturnCDN video streams—no browser automation needed.
- 📥 Built-in Downloader: High-performance chunked file downloads with auto-resume, progress bar support (
tqdm), and custom progress hooks. - ⌨️ CLI Utility: Built-in
animesaturncommand line interface for direct searching, info inspection, and downloading.
Installation
pip install animesaturn
To install with MkDocs documentation dependencies:
pip install "animesaturn[docs]"
Quick Usage
Search Anime
import animesaturn as asaturn
# Search for anime by keyword
results = asaturn.find("One Piece")
for item in results[:5]:
print(f"{item['name']} ({item['year']}) -> {item['link']}")
Anime Details & Metadata
import animesaturn as asaturn
# Initialize anime from link or slug
anime = asaturn.Anime("one-piece-PmTvj")
print(f"Title: {anime.name}")
print(f"Alt Title: {anime.jtitle}")
print(f"Category: {anime.category}")
print(f"Season/Year: {anime.season} ({anime.release})")
print(f"Status: {anime.status}")
print(f"Rating: {anime.rating}/10")
print(f"Genres: {', '.join(anime.genres)}")
print(f"MAL Link: {anime.mal_url}")
print(f"Synopsis: {anime.story}")
Episode Listing & Direct Stream Link
# Get list of episodes
episodes = anime.getEpisodes()
print(f"Total episodes: {len(episodes)}")
first_ep = episodes[0]
print(f"Episode: {first_ep.number}")
# Retrieve server providers
servers = first_ep.getServer()
server = servers[0] # Server principale (SaturnStream)
# Get direct .mp4 streaming link
stream_url = server.fileLink()
print(f"Direct stream URL: {stream_url}")
# File info
info = server.fileInfo()
print(f"File size: {info['total_bytes'] / (1024*1024):.2f} MB")
Downloading Episodes
# Simple download with terminal progress bar
first_ep.download(folder="./downloads")
# Custom progress hook callback
def my_hook(current, total, percentage):
print(f"Progress: {percentage:.1f}% ({current}/{total} bytes)", end="\r")
return True # Return False to abort download
first_ep.download(folder="./downloads", hook=my_hook)
Multi-Domain Management
import animesaturn as asaturn
# View current active domain
print("Active domain:", asaturn.get_domain())
# Fetch all official mirrors from animesaturn.me
domains = asaturn.fetch_official_domains()
print("Official mirrors:", domains)
# Automatically find and switch to the fastest active domain
active = asaturn.discover_active_domain()
print("Fastest active domain set to:", active)
# Manually pin a custom domain
asaturn.set_domain("https://www.animesaturn.tv")
CLI Usage
# Search anime
animesaturn search "Naruto"
# Show anime info
animesaturn info "naruto-shippuden-ita-PjvU1"
# Show latest released episodes
animesaturn latest --page 1
# Download episode 1
animesaturn download "naruto-shippuden-ita-PjvU1" --ep 1 --folder ./downloads
# Check official domains and mirrors
animesaturn domains
Documentation
Full documentation is available at https://animesaturn.lawliet.lol/ or locally with:
mkdocs serve
Disclaimer
This is an unofficial library. It is not affiliated with, endorsed by, or connected to AnimeSaturn.
License
Released under the MIT License.
Star History
Metadata
Release files for animesaturn 1.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| animesaturn-1.0.3.tar.gz | 28.1 kB | Without provenance | Details for animesaturn-1.0.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| animesaturn-1.0.3-py3-none-any.whl | Python 3 | none | any | Details for animesaturn-1.0.3-py3-none-any.whl |
Total release size: 58.5 kB
Release files / animesaturn-1.0.3.tar.gz
| Download URL | animesaturn-1.0.3.tar.gz |
|---|---|
| Size | 28.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
71cbf28180a30c7ae0eba0a798aca3615ce7fcb2d383034fb1730f116bbd98ad
|
|
BLAKE2b-256 checksum How to use checksums |
aa7b7bc3057cb8da193c138cc82dc209193f634fec86d6ad58601e6f01bf7e9e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / animesaturn-1.0.3-py3-none-any.whl
| Download URL | animesaturn-1.0.3-py3-none-any.whl |
|---|---|
| Size | 30.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
257d6f77799e0fe54d0f7a2cfafba0bac81b5f9f69165b6d822850bac745341c
|
|
BLAKE2b-256 checksum How to use checksums |
1b8b9fa51ba90efc7823decffe1c6b3db63ff5d2114d52b30a67a7a5ca032135
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Security for animesaturn 1.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.