Let's be honest. Anime streaming websites are a nightmare. They are filled with intrusive pop-ups, sketchy redirects, and video players that buffer every three seconds. For the true anime fan who wants to build a permanent, high-quality offline archive, there is only one solution: a command-line interface.
Anime Downloader Python CLI is a powerful, open-source terminal tool designed for speed and efficiency. It is not just a simple scraper; it is a complete automation pipeline. You give it the name of a series, and it automatically searches the web, finds the best available quality (up to 1080p), downloads all the episodes, and organizes them into a perfect folder structure.
This repository provides the complete Python source code, along with pre-built Docker images for instant deployment. It features a rich, interactive terminal UI (TUI) that shows you the download progress, speed, and ETA. It is the ultimate tool for data hoarders, travelers, and anyone who refuses to let their favorite shows disappear from the internet.
We have designed the tool to be as simple or as powerful as you need.
Open your terminal and type anidl search "One Piece". The tool instantly queries multiple sources and presents you with a list of available episodes. You can select specific episodes, entire seasons, or a range (e.g., 1-50).
The tool prompts you to choose the video quality (480p, 720p, 1080p) and your preferred audio/subtitle track (Subbed or Dubbed). It automatically fetches the correct subtitle files (SRT or ASS) and embeds them into the video container using FFmpeg.
The CLI uses multi-threaded downloading. It splits the video file into chunks and downloads them simultaneously. This maximizes your bandwidth and bypasses any per-connection speed limits imposed by the server. A 24-minute episode downloads in seconds.
| Feature | Description |
|---|---|
| Multi-Source Scraping | Automatically fails over to backup sources if one is down |
| Batch Downloading | Queue up entire seasons and walk away |
| Subtitle Embedding | Hardcodes or softcodes subtitles using FFmpeg |
| Watch Mode | Tracks your progress and automatically downloads new episodes |
| Terminal UI | A beautiful, progress-bar-driven interface (built with Rich) |
| Cross-Platform | Works natively on Windows, macOS, and Linux |
Anime websites use a variety of obfuscation techniques to hide their video links. Some use base64 encoding, while others use complex JavaScript challenges to generate a temporary token.
Our CLI handles all of this behind the scenes. It uses Selenium to spin up a headless Chrome browser. It navigates to the episode page, waits for the JavaScript to execute, and extracts the final .m3u8 or .mp4 link from the DOM.
Once the link is obtained, the tool passes it to yt-dlp (the legendary downloader engine). yt-dlp handles the actual downloading, ensuring the video and audio streams are merged perfectly.
We are a community of anime fans and Python developers. If you have found a bug in the scraper, added support for a new website, or want to improve the terminal UI, we welcome your contributions!
- Fork the repository.
- Create your feature branch (
git checkout -b feature/new-source). - Commit your changes (
git commit -m 'Add new source'). - Push to the branch (
git push origin feature/new-source). - Open a Pull Request.
Please read our CONTRIBUTING.md for detailed coding standards and testing requirements. We also have an active Discord server where you can share your library setups, ask for help with scraping, and discuss the latest trends in the anime community.
- 💬 Discussions: Join the conversation in the GitHub Discussions tab.
- 🐛 Issues: Found a bug? Let us know via the Issues tracker.
- 📧 Email: Reach out directly at support@anime-cli.dev.