animdl
Download anime episodes
TLDR
Download a specific anime
Download a specific anime by specifying an episode range
Download a specific anime by specifying a download directory
Grab the stream URL for a specific anime
Display the upcoming anime schedule for the next week
Search a specific anime
Stream a specific anime
Stream the latest episode of a specific anime
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)