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

Download the latest release.
Set up the Widevine CDM files (required for decryption).
Add FFmpeg and MKVToolNix (mkvmerge) to the lib folder.
Log in with your Crunchyroll account.
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.

Refer to the filename settings section for detailed instructions on how to configure the settings.

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.

Refer to the sonarr settings section for more information.

Missing subtitle fonts

Crunchyroll no longer provides the old libass font files anymore. Font files must be added manually to the fonts folder.

If subtitles still report missing fonts, download the required files and place them there.

Some fonts can be downloaded here: Fonts.zip

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.

Docker Compose Example

Below is an example docker-compose.yml for running Crunchy Downloader Webtop with the latest published image from GHCR.

It uses simple default values and mounts local folders for config, downloads, and other data. Adjust the paths, ports, and environment variables as needed for your setup.

services:
  webtop:
    image: ghcr.io/crunchy-dl/crunchy-downloader-webtop:<tag>
    container_name: crunchy-downloader-webtop
    restart: unless-stopped
    shm_size: "1gb"
    ports:
      - "3000:3000"
      - "3001:3001"
    environment:
      TZ: "${TZ:-Etc/UTC}"
      PUID: "${PUID:-1000}"
      PGID: "${PGID:-1000}"
      TITLE: "Crunchy Downloader Webtop"
    volumes:
      - ./docker/webtop-config:/config
      - ./docker/crd-data:/crd-data
      - ./docker/local-data:/data