Skip to main content

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"

PyPI version PyPI downloads Python version

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

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)

Source distribution for anisama 2.0.0
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)

Table of built distributions (wheels) for anisama 2.0.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page