Skip to content

A simple crunchyroll downloader.

License

Notifications You must be signed in to change notification settings

TanmoyTheBoT/crdl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

88e79ca · May 16, 2025

History

6 Commits
May 16, 2025
Apr 16, 2025
May 16, 2025
May 16, 2025
May 16, 2025
May 16, 2025

Repository files navigation

crdl 🎬

A command-line tool for downloading content from Crunchyroll with customizable quality options and output settings.

Python Version License PyPI version PyPI Downloads

✨ Features

  • 📺 Download specific episodes, seasons, or entire series
  • 🎨 Choose between different video quality settings
  • 🔐 Automatic token management and stream cleanup
  • 💻 Cross-platform compatibility (Windows, macOS, Linux)
  • 🔑 DRM support with Widevine CDM

📋 Prerequisites

  1. 🐍 Python 3.8+
  2. 📥 N_m3u8DL-RE (in PATH)
  3. 🎬 ffmpeg (in PATH)
  4. 📦 mkvmerge (in PATH)
  5. 🔓 mp4decrypt (in PATH)

For DRM content: Place device.wvd in ~/.config/crdl/widevine/

⚠️ Note: Due to legal reasons, this CDM file is not provided with the project.

📥 Installation

pip install crdl

🚀 Usage

# First time setup with credentials
crdl -u YOUR_USERNAME -p YOUR_PASSWORD -e EPISODE_ID

# Download episode
crdl -e EPISODE_ID

# Browse and Download entire series
crdl -s SERIES_ID

⚙️ Command-Line Options

options:
  -h, --help            show this help message and exit
  --version             Show version information and exit

Authentication:
  --username USERNAME, -u USERNAME
                        Crunchyroll username
  --password PASSWORD, -p PASSWORD
                        Crunchyroll password

Content Selection:
  --series SERIES, -s SERIES
                        Series ID to download
  --season SEASON       Season ID to download
  --episode EPISODE, -e EPISODE
                        Episode ID to download
  --locale LOCALE       Content locale (default: en-US)
  --audio AUDIO, -a AUDIO
                        Audio languages to download (comma-separated, e.g., "ja-JP,en-US" or "all")

Output Options:
  --output OUTPUT, -o OUTPUT
                        Output directory
  --verbose, -v         Enable verbose logging
  --quality {1080p,720p,best,worst}, -q {1080p,720p,best,worst}
                        Video quality (1080p, 720p, best, or worst)
  --release-group RELEASE_GROUP, -r RELEASE_GROUP
                        Release group name for filename

🗂️ Configuration

  ├── credentials.json  # Saved credentials
  ├── json/            # API responses
  ├── widevine/        # DRM files
  │   └── device.wvd   # Required for DRM
  └── logs/            # Application logs

❓ Troubleshooting

  • 🔑 Verify your Crunchyroll credentials and subscription status
  • 📦 Ensure all required tools are updated and in your PATH
  • 🔍 Run with -v for detailed logging
  • 📝 Check logs at: ~/.config/crdl/logs/crunchyroll_downloader.log

⚠️ Disclaimer

This project is for educational purposes only. Please respect Crunchyroll's terms of service and copyright regulations. You need a Crunchyroll Premium subscription to access premium content. This tool is not affiliated with, maintained, authorized, sponsored, or officially associated with Crunchyroll LLC or any of its subsidiaries or affiliates. Use of this application may violate Crunchyroll's Terms of Service and could be illegal in your country. You are solely responsible for your use of this software.

👥 Contributors

TanmoyTheBoT

📄 License

This project is licensed under the MIT License.


© TanmoyTheBoT 2025

Releases

No releases published

Packages

No packages published

Languages