A premium, community-driven platform for automated anime management and downloading. Built with a modern, high-performance architecture and a stunning user interface.
- Sub-per-Sub Catch-up: Periodic series monitoring. Automatically detects and downloads missing episodes even for late subscriptions.
- Multilingual Metadata: Choose your preferred language/region (Spanish, English, etc.) during setup for all series titles and descriptions.
- Native Internationalization (i18n): Fully localized interface in English and Spanish with automatic browser detection and persistent settings.
- Cross-Service Sync: Advanced matching logic that synchronizes catalog metadata (Crunchyroll) with local library storage (AniList/Generic) to prevent duplicate downloads.
- Granular Roles: Permission management for Administrators, Contributors, and Standard Users.
- Audit Logs: Full traceability of all administrative actions.
- Interactive Setup Wizard: A 4-step initial setup to configure your database (SQLite/MySQL), API keys (TMDB/TVDB), and credentials.
- Modern UI/UX: Ultra-responsive dark mode interface with fluid micro-animations and integrated image editors.
- Clone the repository:
git clone --recursive https://github.com/CrunchyDL/CrunchyDL.git cd CrunchyDL - Configure DRM (Optional but recommended):
Place your CDM files in the following folders (created automatically or manually):
widevine/: Client blob and private key (or.wvdfile).playready/:bgroupcert.datandzgpriv.dat.
- Start with Docker:
docker-compose up -d
- Complete the Setup:
Visit
http://localhost:3001and follow the Setup Wizard to initialize your administrator account and services.
If you prefer to run the application directly on your host system (Windows or Linux) without Docker, follow these steps:
- Node.js: v18 or later.
- FFmpeg: Must be installed and in your system's PATH.
- Git: For cloning and submodules.
- DRM Tools (Windows): Either mp4decrypt or shaka-packager must be in your PATH for decryption to work.
We provide helper scripts to automate the build and dependency installation:
Windows (PowerShell):
.\scripts\setup-native.ps1Linux (Bash):
bash scripts/setup-native.sh- Initialize Submodules:
git submodule update --init --recursive - Frontend Build:
cd frontend && npm install && npm run build - Prepare Backend: Copy
frontend/dist/*tobackend/public/ - Backend Setup:
cd backend && npm install - Submodule Build:
cd backend/multi-downloader-nx && npm install && npm run tsc false false - Start Server:
cd backend && node index.js
Once the setup is complete, you can start the server using the launchers in the root directory:
- Windows: Double-click
run-windows.bat - Linux: Run
bash run-linux.sh
Visit http://localhost:3001 to use the application.
For a more integrated experience on Windows and Linux, we provide a lightweight System Tray launcher that allows you to start the server and open the web interface from your taskbar.
Before using it for the first time, you need to compile the binary:
Windows:
- Double-click
build-launcher.bat
Linux:
- Run
bash build-launcher.sh
Once built, you can start it using:
- Windows: Double-click
start-launcher.bator runlauncher-bin/crunchydl-launcher.exe - Linux: Run
launcher-bin/crunchydl-launcher(ensure it has execute permissions:chmod +x)
Right-click the orange icon in your system tray to access the menu.
This application uses the multi-downloader-nx core for decryption. To enable high-quality downloading (1080p+), you must provide your own CDM (Content Decryption Module) files.
- Widevine: Recommended for most content. Put your files in the root
/widevinefolder. - Playready: Supported for specific streams. Put your files in the root
/playreadyfolder.
Important
Legal Disclaimer: This software is intended for personal, educational, and research purposes ONLY. We do not provide any copyrighted content, decryption keys, or bypasses for digital rights management. The user is solely responsible for obtaining the necessary credentials and CDM files from their own legal devices and complying with the Terms of Service of any platform accessed.
| Layer | Technologies |
|---|---|
| Frontend | React 18, Vite, Vanilla CSS, Lucide Icons, i18next |
| Backend | Node.js, Express, Undici, FFmpeg |
| Database | SQLite (default) / MySQL (optional) |
| Infrastructure | Docker & Docker Compose |
If you like the project and want to support its development, you can buy me a coffee:
You can also see our list of amazing Donors.
Join our Discord Server to get support, share suggestions, or just chat with other users!
Licensed under the PolyForm Noncommercial 1.0.0. Personal and hobbyist use is permitted; commercial use is strictly prohibited.
See the LICENSE file for more details.