Skip to content
Elwador edited this page Mar 12, 2026 · 9 revisions

Welcome to the Crunchy-Downloader wiki!

Crunchy-Downloader is a tool that allows you to download your favorite series and episodes directly from Crunchyroll.

🚀 Getting Started

  1. Download the latest release.
  2. Set up the Widevine CDM files (required for decryption).
  3. Add FFmpeg and MKVToolNix (mkvmerge) to the lib folder.
  4. Log in with your Crunchyroll account.
  5. Configure your download settings.

📜 Disclaimer

I am in no way affiliated with, maintained, authorized, sponsored, or officially associated with Crunchyroll LLC or any of its subsidiaries or affiliates. The official Crunchyroll website can be found at https://crunchyroll.com/.

This tool is meant for private use only. You need a Crunchyroll Premium subscription to access premium content.

The usage of this application may also cause a violation of the Terms of Service between you and the stream provider.

This application enables you to download videos for offline viewing which may be forbidden by law in your country. You are entirely responsible for what happens when you use crunchy-downloader.

FAQ

Error: "Can't find cdm files in widevine folder"

This error indicates that the necessary CDM (Content Decryption Module) files are missing in the Widevine folder, which are essential for decryption during the download process. To resolve this issue:

  • Visit the README.md file on the Crunchy-Downloader GitHub repository for instructions on setting up the CDM files.
  • Check the discussion here for more information on the CDM files.

Ensure that you have correctly set up the Widevine CDM files according to the provided instructions.

How to Create Series/Season Folders?

To create folders for each series or season, you need to adjust the filename settings in the settings tab of the downloader.

Episodes or seasons appear with incorrect numbering in Plex / Jellyfin

Crunchyroll sometimes provides inconsistent or incorrect season and episode numbering. Because the downloader uses this metadata by default, the resulting files may appear with incorrect numbering in media servers like Plex or Jellyfin.

To improve this, you can enable Sonarr numbering.

When enabled, Crunchy-Downloader will use episode and season information from Sonarr instead of relying only on Crunchyroll's metadata.

Crunchy-Downloader Startup Parameters

The Crunchy-Downloader offers several startup parameters to customize its behavior. Below is a list of available options and their functionalities. For further discussions and updates, refer to the GitHub Discussion.

Available Parameters

Parameter Description
--headless Launches the downloader without a graphical user interface.
--historyRefreshAll Refreshes the entire download history on startup.
--historyRefreshActive Refreshes only the Active history entries.
--historyAddToQueue Automatically adds missing episodes to the download queue.
--exit Exits the downloader after all tasks are completed.

Clone this wiki locally