LinuxCommandLibrary

animdl

Download anime episodes

TLDR

Download a specific anime

$ animdl download [anime_title]
copy

Download a specific anime by specifying an episode range
$ animdl download [anime_title] [[-r|--range]] [start_episode]-[end_episode]
copy

Download a specific anime by specifying a download directory
$ animdl download [anime_title] [[-d|--download-dir]] [path/to/download_directory]
copy

Grab the stream URL for a specific anime
$ animdl grab [anime_title]
copy

Display the upcoming anime schedule for the next week
$ animdl schedule
copy

Search a specific anime
$ animdl search [anime_title]
copy

Stream a specific anime
$ animdl stream [anime_title]
copy

Stream the latest episode of a specific anime
$ animdl stream [anime_title] [[-s|--special]] latest
copy

SYNOPSIS

animdl [OPTIONS] URL
animdl [OPTIONS] search-query

PARAMETERS

-h, --help
    Displays the help message and exits.

-v, --version
    Shows the program's version number and exits.

-o DIRECTORY, --output DIRECTORY
    Specifies the directory where the downloaded files will be saved.

-q QUALITY, --quality QUALITY
    Sets the preferred video quality for download (e.g., "720p", "1080p").

-e EPISODES, --episode EPISODES
    Downloads specific episodes or a range (e.g., "1,3,5" or "1-10").

-S SOURCE, --source SOURCE
    Specifies the streaming source or website to download from. Use --list-sources to see available options.

--search QUERY
    Searches for anime matching the given query instead of downloading from a URL.

--auto-select
    Automatically selects the best available quality for download.

--force-download
    Forces the download even if the file already exists in the output directory.

--list-sources
    Lists all supported anime streaming sources that animdl can download from.

--list-qualities
    Displays available video qualities for a given URL without initiating the download.

--skip-download
    Skips the actual video download, only extracting and displaying information about the content.

--no-mux
    Prevents animdl from muxing video and audio streams into a single file after download.

--verbose
    Enables verbose output, showing more detailed information during the process.

--ffmpeg-location PATH
    Specifies the custom path to the ffmpeg executable if it's not in the system's PATH.

DESCRIPTION

animdl is a powerful, open-source command-line utility designed for downloading anime from a wide array of online streaming services.
Built with Python, it offers a versatile solution for users who prefer to watch anime offline or manage their personal media libraries.
The tool supports downloading individual episodes, entire seasons, or even complete series, providing flexibility in how content is acquired.
It intelligently parses episode information, handles quality selection, and can integrate with external tools like ffmpeg for muxing and format conversion, ensuring a complete and high-quality download experience.
animdl aims to be a one-stop solution for anime enthusiasts, abstracting the complexities of web scraping and content acquisition into a simple, easy-to-use command-line interface.

CAVEATS

animdl relies on web scraping, meaning its functionality can be affected by changes to anime streaming website layouts.
Users should ensure ffmpeg is installed and accessible for proper muxing and format conversion.
Always be aware of copyright laws and terms of service regarding downloading copyrighted content in your region.

INSTALLATION

animdl is typically installed via pip, the Python package installer.
The most common installation command is:
pip install animdl
It is recommended to use a virtual environment to manage dependencies.
Users also need to ensure that ffmpeg is installed and accessible in their system's PATH for full functionality, particularly for muxing audio and video streams.

HISTORY

animdl is an active open-source project primarily developed on GitHub. Its development focuses on continuously adapting to changes in anime streaming websites and expanding its list of supported sources. As a Python-based utility, it leverages community contributions for bug fixes and feature enhancements, typical of many web-scraping tools that require frequent updates to maintain compatibility with dynamic web content.

SEE ALSO

youtube-dl(1), yt-dlp(1), ffmpeg(1), wget(1)

Copied to clipboard