About
Welcome to anisama, a Python library + CLI for multi-source anime scraping, search, and video resolution.
- Scrapes 6 sources: Anime-Sama, Voiranime, MyFluneo, AnimesUltra, French-Anime, AnimoFlix.
- Fuzzy search with rapidfuzz across all sources with intelligent dedup.
- Video URL resolution for 10+ hosting providers.
- Unified source registry for use by CLI and API frontends.
- Built-in interactive CLI (click + questionary + rich) —
anisama "demon slayer"
Project Structure
anisama/
├── src/
│ ├── __init__.py # Version and top-level exports
│ ├── config.py # Constants, headers, domains, paths
│ ├── cache.py # Catalog CRUD, multi-source merge
│ ├── search.py # Fuzzy search (rapidfuzz)
│ ├── http_client.py # Shared httpx.Client singleton (HTTP/2)
│ ├── resolver.py # Video URL resolution per host
│ ├── sources.py # Source registry + unified API
│ ├── exceptions.py # Custom exceptions
│ ├── scraper/
│ │ ├── __init__.py # Re-exports all scrapers
│ │ ├── base.py # Shared helpers, domain discovery
│ │ ├── anime_sama.py # Anime-Sama scraper
│ │ ├── voiranime.py # Voiranime scraper
│ │ ├── myfluneo.py # MyFluneo scraper (Playwright)
│ │ ├── animesultra.py # AnimesUltra scraper
│ │ ├── frenchanime.py # FrenchAnime scraper
│ │ └── animoflix.py # AnimoFlix scraper (Playwright)
│ └── cli/
│ ├── __init__.py
│ ├── app.py # Click entry point & main menu
│ ├── display.py # Rich console, banners, panels
│ ├── workflow.py # Search → pick → play workflow
│ ├── picker.py # Episode & mirror selection
│ ├── player.py # Video player launcher (mpv/vlc/…)
│ ├── settings.py # Settings menu (lang, player, proxy)
│ ├── config.py # CLI-specific config helpers
│ ├── install.py # Dependency installer
│ ├── mirror.py # Mirror selection logic
│ └── api_client.py # Optional API backend client
├── data/ # Local catalog/settings storage
├── tests/ # Pytest suite (125+ tests)
└── pyproject.toml
Installation
From PyPI (recommended)
pip install anisama
With Playwright support
pip install anisama[playwright]
playwright install chromium
From source
git clone https://github.com/6sfy/anisama.git
cd anisama
pip install -e .
Usage
As a CLI tool
# Interactive mode (launches menu)
anisama
# Search and play
anisama "demon slayer"
anisama --lang vf "attack on titan"
anisama --download "one piece"
anisama -e 1-5 "naruto"
# Settings
anisama --settings
As a library
from anisama import cache, search, resolver
from anisama.scraper import anime_sama, voiranime
from anisama.scraper.base import find_active_domain
from anisama.sources import SOURCES
from anisama.config import KNOWN_DOMAINS, DEFAULT_HEADERS
# Find active domain
domain = find_active_domain()
# Download catalog
catalog = cache.download_combined_catalog(domain)
# Search
results = search.search_combined("demon slayer", catalog, domain)
# Get episodes
seasons = anime_sama.get_anime_seasons(results[0]["link"])
episodes = anime_sama.get_episodes(seasons[0]["url"])
# Resolve video URL
video = resolver.resolve_url(episodes[0]["mirrors"]["eps1"])
# Use the unified source registry
for name, source in SOURCES.items():
print(f"{name}: {source.description}")
Configuration
ANISAMA_DATA_DIR— Override the data directory (default:<project_root>/data)ANISAMA_PLAYWRIGHT_EXECUTABLE_PATH— Path to Playwright Chromium executable
Sources
| Source | Language | Method |
|---|---|---|
| Anime-Sama | VOSTFR/VF | HTML scraping |
| Voiranime | VOSTFR/VF | HTML scraping |
| MyFluneo | VOSTFR | Playwright |
| AnimesUltra | VOSTFR/VF | Sitemap/HTML |
| French-Anime | VOSTFR/VF | HTML scraping |
| AnimoFlix | VOSTFR | HTML + Playwright |
Contributing
- Before creating an issue, please ensure that it hasn't already been reported/suggested.
- See the contribution guide if you'd like to submit a PR.
Credits
- pystardust/ani-cli for the original idea and workflow
- Content sources: Anime-Sama, Voiranime, MyFluneo, AnimesUltra, French-Anime, AnimoFlix
Metadata
Release files for anisama 2.0.0
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 |
|---|---|---|---|---|
| anisama-2.0.0.tar.gz | 58.4 kB | With provenance | Details for anisama-2.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| anisama-2.0.0-py3-none-any.whl | Python 3 | none | any | Details for anisama-2.0.0-py3-none-any.whl |
Total release size: 123.3 kB
Release files / anisama-2.0.0.tar.gz
| Download URL | anisama-2.0.0.tar.gz |
|---|---|
| Size | 58.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
903c539997f2ffd71eda103c72dd906fd0fac9afe6a8b45f38f189142d09df85
|
|
BLAKE2b-256 checksum How to use checksums |
3237aed197be2f25bc6c5ab8ed959369d447a6bc6548c711d4a84412f3b96c67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logRelease files / anisama-2.0.0-py3-none-any.whl
| Download URL | anisama-2.0.0-py3-none-any.whl |
|---|---|
| Size | 65.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d52a72e51cdcc0e0396526622f9970e7d89e489ba4ebf1f5a27a75cb79ce4172
|
|
BLAKE2b-256 checksum How to use checksums |
e4ee1d583660583d1c656469bbf62f2f57df6fe69fac58299a643845b974fde9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logSecurity for anisama 2.0.0
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for anisama-2.0.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency logA 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.