https://github.com/sertrafurr/anime-sama-downloader
Have you ever felt like, AWW, I want to download this super cool anime, you can't seem to understand how to? then use this cool program (We love PY)
https://github.com/sertrafurr/anime-sama-downloader
anime anime-downloader anime-sama downloader py python sendvid sibnet streaming-video
Last synced: 10 months ago
JSON representation
Have you ever felt like, AWW, I want to download this super cool anime, you can't seem to understand how to? then use this cool program (We love PY)
- Host: GitHub
- URL: https://github.com/sertrafurr/anime-sama-downloader
- Owner: SertraFurr
- License: gpl-3.0
- Created: 2025-08-22T19:38:30.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-22T22:30:00.000Z (10 months ago)
- Last Synced: 2025-08-22T22:47:03.448Z (10 months ago)
- Topics: anime, anime-downloader, anime-sama, downloader, py, python, sendvid, sibnet, streaming-video
- Language: Python
- Homepage:
- Size: 42 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎌 Anime-Sama Video Downloader
**🚀 A powerful, beautiful and simple CLI tool to download anime episodes from anime-sama.fr**
*Enhanced with colorful interface, smart source detection, and robust error handling*
*Questions? Unworking urls? Open an issue, will be added fastly (hopefully)*
## ✨ Features
### 🎯 **Smart & Intuitive**
- 🌈 **Beautiful CLI Interface** with colors and emojis
- 🔍 **Auto URL Validation** with helpful error messages
- 📝 **Built-in Tutorial** for first-time users
- ⚡ **Multi-threaded Downloads** for blazing fast performance
### ⚡ **Powerful & Reliable**
- 🎪 **Multiple Player Support** (Player 1, 2, 3...)
- 🔄 **Smart Source Detection** (SendVid, Sibnet)
- 📊 **Real-time Progress** with download speeds
- 🛡️ **Robust Error Handling** with retry logic
---
## 🚀 Quick Start
### 📋 Prerequisites
🐍 Python Requirements
Make sure you have **Python 3.6+** installed:
```bash
# Check Python version
python --version
# Install required packages
pip install requests beautifulsoup4 tqdm
```
**Required Libraries:**
- `requests` - HTTP requests handling
- `beautifulsoup4` - HTML parsing
- `tqdm` - Progress bar display
### ⚡ Installation & Usage
```bash
# 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 the magic! ✨
python3 main.py
```
---
## 📖 Complete Usage Guide
🎯 Three Simple Steps
### 1️⃣ Find Anime
Visit **[anime-sama.fr](https://anime-sama.fr/catalogue/)**
🔍 Search your anime
📺 Select season & language
📋 Copy the complete URL
### 2️⃣ Run Script
Launch the downloader
🖥️ Paste the URL
🎮 Choose player & episode
📁 Set download folder
### 3️⃣ Enjoy!
Watch the magic happen
⬇️ Auto-download starts
📊 Real-time progress
🎉 Episode ready to watch!
### 🔗 Example URLs
```bash
# ✅ Perfect URL format
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/ # Missing season/language
https://anime-sama.fr/ # Just homepage
```
---
## 🛠️ Video Source Support
| Platform | Status | Performance | Notes |
|:--------:|:------:|:-----------:|:------|
| 📹 **SendVid** |  | 🔄 Good | Primary recommended source |
| 🎬 **Sibnet** |  | 🔄 Good | Reliable backup source |
| 🎬 **ONEUPLOAD** |  | 🔄 Good | Download .ts file then make them into an mp4 back. |
| 🎬 **Vidmoly** |  | 🔄 Good | Download .ts file then make them into an mp4 back. |
| 🎬 **MOVEARNPRE** |  | 🔄 SLOW | Download .ts file then make them into an mp4 back. |
| 🚫 **MYVI** |  | ❌ None | Scam website, only redirect to advertisement. |
| 🤔 **VK.com** |  | ❌ None | Could try, but did not find any working URL. |
---
## 📸 Screenshots
🖼️ View CLI Interface Screenshots
### 🎨 Main Interface
```
╔══════════════════════════════════════════════════════════════╗
║ ANIME-SAMA VIDEO DOWNLOADER ║
║ Enhanced CLI v2.0 ║
╚══════════════════════════════════════════════════════════════╝
📺 Download anime episodes from anime-sama.fr easily!
```
### 🎮 Player Selection
```
🎮 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:
```
### 📊 Download Progress
```
⬇️ DOWNLOADING
─────────────────────────────────────────────────────────────────
📥 roshidere_episode_1.mp4: 100%|████████| 145M/145M [02:15<00:00, 1.07MB/s]
✅ Download completed successfully!
```
---
## ⚙️ Configuration
🔧 Customization Options
### 📁 Default Settings
- **Download Directory**: `./videos/`
- **Video Format**: `.mp4`
- **Naming Convention**: `{anime_name}_episode_{number}.mp4`
### 🎨 Color Themes
The script uses a beautiful color scheme:
- 🔵 **Info**: Cyan messages
- ✅ **Success**: Green confirmations
- ⚠️ **Warning**: Yellow alerts
- ❌ **Error**: Red error messages
- 💜 **Headers**: Purple titles
---
## 🤝 Contributing
We welcome contributions! Here's how you can help:
[](https://github.com/sertrafurr/Anime-Sama-Downloader/issues)
[](https://github.com/sertrafurr/Anime-Sama-Downloader/pulls)
[](https://github.com/sertrafurr/Anime-Sama-Downloader/discussions)
### 🐛 Found a Bug?
1. Check existing [issues](https://github.com/sertrafurr/issues)
2. Create a new issue with:
- 📝 Clear description
- 🔄 Steps to reproduce
- 💻 System information
### 💡 Feature Request?
1. Open a [discussion](https://github.com/sertrafurr/discussions)
2. Explain your idea
3. Community feedback welcome!
---
## 📄 License
This project is licensed under the **GNU v3 License**
[](https://opensource.org/licenses/MIT)
*Feel free to use, modify, and distribute!*
---
## ⚠️ Disclaimer
📢 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
---
## 🙏 Acknowledgments
**🧠 Core algorithms and video extraction logic: Human-developed**
**🎨 Code restructuring and user interface enhancements: AI-assisted**
---
### 🌟 Star this repo if it helped you!
[](https://github.com/sertrafurr/anime-sama-downloader/stargazers)
You wish for something a service to get removed/added, open an issue.