🚀 Crunchy-Bot/CLI 🎬

Crunchy-Bot/CLI is your ultimate tool to download Crunchyroll videos seamlessly. Whether you prefer the command-line interface (CLI) or want a more interactive experience through a Telegram bot, this tool has you covered! It supports everything from decryption, merging, metadata tagging, multiple audio/subtitle selections, batch downloads, and even optional watermarking. All this wrapped up in a sleek and easy-to-use interface.

---

🔥 Features

• 🎥 Download Crunchyroll Episodes or Entire Series with ease
• 💻 CLI & Telegram Bot Interface for flexible usage
• 🔐 DRM Decryption via Widevine L3 & mp4decrypt
• 📺 Choose Video Quality (360p, 480p, 720p, 1080p, or original)
• 🎶 Select Audio Tracks (multiple languages supported)
• 📝 Subtitles & Captions (VTT to SRT conversion)
• 🔄 Merge Video, Audio, and Subtitles with FFmpeg
• 📝 Custom Naming (file format, optional watermark)
• 🚀 Upload Final File Directly to Telegram
• 👤 Role-based Access Control (Regular, Premium, Sudo Users)

---

🛠️ Prerequisites

Before getting started, you'll need:

1. Widevine L3 (l3.wvd) File

   • Required for DRM decryption.
   • Not included in the repo—please provide your own.
   • Place it in the project root directory alongside cli.py and tg.py.

2. mp4decrypt Binary

   • Needed for decrypting video and audio segments.
   • Ensure it's in the root folder or accessible via PATH.
   • On Linux/macOS:

     chmod +x mp4decrypt

---

📥 Installation

Get started by cloning the repo and installing dependencies:

git clone https://github.com/ToonTamilIndia/Crunchy-Bot-CLI.git
cd Crunchy-Bot-CLI

Optional: Create a Virtual Environment

python3 -m venv venv
source venv/bin/activate

Install Required Dependencies

pip install -r requirements.txt

---

⚙️ Configuration

Edit the config.py file to set up your personal settings:

• Crunchyroll Credentials (optional): Email, Password
• Telegram Bot Credentials: BOT_TOKEN, API_ID, API_HASH
• Watermark, File Naming, Debug Options, etc.
• Access Control: Define sudo_users, premium_users, and more!

---

🖥️ CLI Usage Guide

Run the CLI

source venv/bin/activate
python3 cli.py

Download Workflow

1. Enter Crunchyroll URL:

   • Single Episode: https://www.crunchyroll.com/watch/GXXXXXX
   • Series: https://www.crunchyroll.com/series/GXXXXXX

2. Select Your Options:

   • Video Quality: Choose from 360p, 480p, 720p, 1080p
   • Audio Tracks: Choose one or more languages
   • Subtitles: Choose subtitle languages

3. Download Process:

   • Downloads video, audio, and subtitles
   • Converts subtitles from VTT to SRT if necessary
   • Decrypts with mp4decrypt
   • Merges all streams using FFmpeg
   • Optional Watermarking
   • Saves a final .mkv file

---

🤖 Telegram Bot Usage Guide

Run the Bot

source venv/bin/activate
python3 tg.py

How It Works:

1. Start the Bot: Send /start on Telegram to begin.

2. Send Crunchyroll Link:

   /download https://www.crunchyroll.com/watch/GXXXXXX

3. Interactive Workflow:

   • Choose Video Quality via buttons
   • Select Audio Tracks (multiple options available)
   • Choose Subtitles/Captions languages
   • Review your selections
   • Download, decrypt, merge, and get your final video directly on Telegram

User Roles:

• Regular Users: Max 2 audio tracks, 480p quality
• Premium Users: Unlimited audio tracks, no resolution limits
• Sudo Users: Admins with full access and controls

Bot Commands:

Command	Description
/start	Show welcome message
/help	Display available commands
/download <url>	Start downloading the content
/cancel	Cancel the current download session

Admin (Sudo) Commands:

Command	Description
/addpremium <user_id>	Add a user to the Premium tier
/rempremium <user_id>	Remove Premium access from a user
/listpremium	Show list of Premium users
/addsudo <user_id>	Add a new Sudo (admin) user
/remsudo <user_id>	Remove Sudo privileges
/listsudo	Show list of all Sudo users

---

🚀 Deployment Options

Docker

Run in a containerized environment:

docker build -t crunchy-bot-cli .
docker run -d --name crunchy-bot-cli 

---

VPS / Self-Hosting

1. Connect to your VPS or server via SSH.
2. Ensure Python 3 and pip are installed.
3. Follow the Installation steps (clone repo, install dependencies, preferably in a virtual environment).
4. Place your l3.wvd file and the executable mp4decrypt binary in the project directory.
5. Configure config.py as needed.
6. Running Persistently (especially for the Telegram bot):
   • Using tmux or screen:
     • Start a new session: tmux new -s crunchybot
     • Activate virtual environment: source venv/bin/activate
     • Run the script: python3 tg.py
     • Detach from the session: Press Ctrl+b then d. The script will keep running.
     • Reattach later: tmux attach -t crunchybot
   • Using systemd (Linux):
     • Create a service file (e.g., /etc/systemd/system/crunchybot.service).

       [Unit]
       Description=Crunchyroll Telegram Bot Service
       After=network.target
       
       [Service]
       User=your_username # Replace with the user the bot should run as
       Group=your_group   # Replace with the user's group
       WorkingDirectory=/path/to/Crunchy-Bot-CLI # Replace with the actual path
       ExecStart=/path/to/Crunchy-Bot-CLI/venv/bin/python3 /path/to/Crunchy-Bot-CLI/tg.py # Adjust path to python if not using venv
       Restart=always # Or 'on-failure'
       StandardOutput=file:/var/log/crunchybot.log # Optional: Log output
       StandardError=file:/var/log/crunchybot.err.log # Optional: Log errors
       
       [Install]
       WantedBy=multi-user.target

     • Reload systemd: sudo systemctl daemon-reload
     • Enable the service (to start on boot): sudo systemctl enable crunchybot.service
     • Start the service: sudo systemctl start crunchybot.service
     • Check status: sudo systemctl status crunchybot.service

---

💡 Credits

This project is inspired by and adapted from:

• Yoimi by NyaShinn1204

---

⚖️ Disclaimer

This project is intended for educational purposes only.
You are responsible for following copyright laws and platform terms.

---

© ToonTamilIndia & ToonEncodesIndia 2025 - 2026