animdl

Download a specific anime

$ animdl download [anime_title]

$ animdl download [anime_title] [[-r|--range]] [start_episode]-[end_episode]

$ animdl download [anime_title] [[-d|--download-dir]] [path/to/download_directory]

$ animdl grab [anime_title]

$ animdl schedule

$ animdl search [anime_title]

$ animdl stream [anime_title]

$ animdl stream [anime_title] [[-s|--special]] latest

animdl [OPTIONS] <PROVIDER> <QUERY>

-h, --help
    Show help message and exit.

--version
    Print version information.

--config DIR
    Custom config directory path.

--logs DIR
    Custom logs directory path.

--player PLAYER
    External player (e.g., mpv, vlc).

--quality QUALITY
    Video quality (e.g., 1080p, 720p, best).

--dub
    Prefer dubbed episodes.

--sub
    Prefer subbed episodes (default).

--skip-download
    Stream only, no download.

--batch
    Download all available episodes.

--threads THREADS
    Download threads count (default: 3).

--range RANGE
    Episode range (e.g., 1-12).

--select SELECT
    Interactive episode selection.

--last
    Download only latest episode.

animdl is a lightweight, high-speed command-line tool for discovering, streaming, and downloading anime episodes from popular online providers like gogoanime, 9anime, and zoro.to. It leverages yt-dlp for robust downloads and supports mpv or other players for seamless playback.

Key features include multi-threaded downloading for efficiency, quality selection (e.g., 1080p, 720p), dubbed/subbed language options, episode range specification, batch mode for full seasons, and interactive episode selection. Users can stream directly without downloading or queue episodes for later.

The tool emphasizes simplicity: search with a provider and query, then choose actions via flags. It's Python-based, pip-installable, and cross-platform on Linux, requiring minimal dependencies like ffmpeg for muxing. Ideal for terminal enthusiasts seeking ad-free anime access, but users must respect content legality.

Configuration is flexible via ~/.config/animdl, with logging and custom players supported. Regularly updated for provider changes, ensuring reliability.

Requires Python 3.8+, ffmpeg, and yt-dlp. Downloading copyrighted anime may violate laws; use VPN responsibly. Provider availability fluctuates; check GitHub for updates.

pip install animdl; or pipx install animdl for isolation. Update with pip install -U animdl.

gogo, 9anime, zoro, hianime, animepahe, allanime, crunchyroll (partial). Run animdl --help for full list.

animdl gogo 'One Piece' --quality 1080p --range 1000-1005 --threads 5
animdl 9anime naruto --dub --player mpv

Developed by JustSomeOne starting 2022; open-source on GitHub (stars: 1k+). Evolved from anime-dl, now feature-rich with active maintenance for new providers and bug fixes.

yt-dlp(1), mpv(1), ffmpeg(1)