-lightgrey.svg?style=for-the-badge){kind=icon}
🚀 A powerful, beautiful and simple CLI tool to download anime episodes from anime-sama.(any)
(✨26 STARS✨! Thanks!)
Enhanced with colorful interface, smart source detection, and robust error handling
Questions? Unworking urls? Open an issue, will be added fastly (hopefully)
It also works on unreleased episodes ! (Where it says 'This content does not exist.' sometimes it still exist.)
Looking for projects to do ! feel free to request in issue !
|
|
🐍 Python Requirements
Make sure you have Python 3.6+ installed:
# Check Python version
python --version
# Install required packages
pip install requests beautifulsoup4 tqdmRequired Libraries:
requests- HTTP requests handlingbeautifulsoup4- HTML parsingtqdm- Progress bar display
# 1. Clone the repository.
git clone https://github.com/SertraFurr/Anime-Sama-Downloader.git
# 2. Navigate into the project directory.
cd Anime-Sama-Downloader
# 3. Run it.
python3 main.py
# Or use the CLI arguments.
python3 main.py --helpYou can use the script entirely from the command line without interactive prompts.
| Argument | Description | Example | Default |
|---|---|---|---|
--search |
Search for an anime by name | --search "naruto" |
None |
--url |
Direct URL to anime season/page | --url "https://..." |
None |
--episodes |
Select episodes to download | --episodes "1,2" |
None |
--player |
Select specific player (fuzzy match) | --player "Sibnet" |
None |
--dest |
Base download directory (auto-creates folders) | --dest "C:/X" |
Config Folder |
--threads |
Enable threaded episode downloads | --threads |
False |
--fast |
Enable multi-threaded .ts download (10x faster) | --fast |
False |
--mp4 |
Auto-convert .ts to .mp4 | --mp4 |
False |
--tool |
Select conversion tool (av/ffmpeg) | --tool av |
av |
--latest |
Download only the latest episode | --latest |
False |
--no-mal |
Disable MyAnimeList research | --no-mal |
False |
1. Search and Download Interactively:
python main.py --search "roshidere"2. Download Specific Episodes from URL (Fast Mode):
python main.py --url "https://anime-sama.tv/catalogue/roshidere/saison1/vostfr/" --episodes "1,2" --fast --mp43. Download ALL episodes from a specific player:
python main.py --search "one piece" --player "Sibnet" --episodes "all" --threads
Visit anime-sama
|
Launch the downloader
|
Watch the magic happen
|
🔗 Example URLs
✅ Works
- https://anime-sama.fr/catalogue/roshidere/saison1/vostfr/
- https://anime-sama.fr/catalogue/demon-slayer/saison1/vf/
- https://anime-sama.fr/catalogue/attack-on-titan/saison3/vostfr/
- https://anime-sama.fr/catalogue/one-piece/saison1/vostfr/
❌ Won’t work
- https://anime-sama.fr/catalogue/roshidere/
- https://anime-sama.fr/
| Platform | Status | Performance | Notes |
|---|---|---|---|
| Threaded mode is only suitable for strong Wi-Fi connections that won't crash when handling multiple downloads simultaneously. | |||
| 📹 SendVid |  |
✅ Good | Primary recommended source |
| 🎬 Sibnet | |
✅ Good | Reliable backup source |
| 🎬 Vidmoly | |
✅ SLOW if not threaded. FASTEST if | Download .ts file then make them into an mp4 back. |
| 🎬 ONEUPLOAD | |
✅ SLOW if not threaded. Very fast if | Download .ts file then make them into an mp4 back. |
| 🎬 EMBED4ME | |
✅ SLOW if not threaded. Very fast if | Download .ts file then make them into an mp4 back. |
| 🎬 MOVEARNPRE |  |
✅ SLOW if not threaded. Very fast if | Download .ts file then make them into an mp4 back. INCONSISTENT |
| 🎬 SMOOTHPRE | |
✅ SLOW if not threaded. Very fast if | Download .ts file then make them into an mp4 back. INCONSISTENT |
| 🎬 MIVALYO | |
✅ SLOW if not threaded. Faster if | Download .ts file then make them into an mp4 back. INCONSISTENT |
| 🎬 DINGTEZUNI | |
✅ SLOW if not threaded. Faster if | Download .ts file then make them into an mp4 back. INCONSISTENT |
| 🚫 MYVI |  |
❌ None | Malicious website, only redirect to advertisement. |
| 🚫 MINOCHINOS |  |
❌ None | Does not work in some countries, useless to implement. |
| 🤔 VK.com | |
❌ None | Could try, but did not find any working URL. |
🖼️ View CLI Interface Screenshots
╔══════════════════════════════════════════════════════════════╗
║ ANIME-SAMA VIDEO DOWNLOADER ║
║ Enhanced CLI v2.0 ║
╚══════════════════════════════════════════════════════════════╝
📺 Download anime episodes from anime-sama.fr easily!
🎮 SELECT PLAYER
─────────────────────────────────────────────────────────────────
1. Player 1 (12/15 working episodes)
2. Player 2 (8/15 working episodes)
3. Player 3 (15/15 working episodes)
Enter player number (1-3) or type player name:
⬇️ DOWNLOADING
─────────────────────────────────────────────────────────────────
📥 roshidere_episode_1.mp4: 100%|████████| 145M/145M [02:15<00:00, 1.07MB/s]
✅ Download completed successfully!
🔧 Customization Options
Download Directory: ./videos/
Video Format: .mp4
Naming Convention: {anime_name}_episode_{number}.mp4
The script uses a beautiful color scheme:
🔵 Info: Cyan messages
✅ Success: Green confirmations
❌ Error: Red error messages
💜 Headers: Purple titles
We welcome contributions! Here's how you can help:
Check existing issues Create a new issue with: 📝 Clear description 🔄 Steps to reproduce 💻 System information
Open a discussion Explain your idea Community feedback welcome!
This project is licensed under the GPL v3 License
Feel free to use, modify, and distribute!
📢 Important Notice
🎯 This tool is for educational purposes only
📺 Respect copyright laws in your jurisdiction
🔒 Use responsibly and in compliance with anime-sama.fr's terms
** Core algorithms and video extraction logic: Human-developed**
** Code restructuring and user interface enhancements: AI-assisted**
You wish for something/a service to get removed/added, open an issue.