crunchyroll-dl

A fast, modern, and beautiful Crunchyroll downloader.

Downloads the Crunchyroll videos with the subtitles hardsubbed or softsubbed.

Features

• Download an entire series or just a single episode
  • Specify which seasons to download from a series (or download them all)
  • Specify which episodes to download
• Use the USA library of Crunchyroll (unblock)
• Specify download resolution
• Custom output of file names
• Colourful user interface

Requirements

• node.js 8+
• ffmpeg
• mkvmerge (optional: if you want to use soft subtitles)

Installation

npm install -g crunchyroll-dl

CLI Options

Authentication

• --username, -u username/email
• --password, -p password
• --unblocked use a USA Crunchyroll session (default: false)

Downloading

• --input, -i (required) the episode/series to download
• --language, -l the language to download (default: enUS, see below for other options)
• --quality, -q the quality/resolution to download (default: auto)
• --dont-autoselect-quality don't automatically select quality if requested is not available (i.e. if 1080p was specified and is not available, fail)
• --download-all, -a download all collections (no dialog)
• --ignore-dubs attempt to ignore dubs
• --episodes, -e episode ranges
  • examples
    • --episodes 1-2,12-15,18-20
    • -e 1,3,5,7
• --output, -o the output file name (default: :name Episode :ep [:resolution])
  • can use components to customize
    • :name name of collection
    • :epname name of episode
    • :resolution resolution of the video
    • :ep the episode number
    • :series the series name
• --vilos fetch the videos/subtitles from the Crunchyroll web page. will not work with the unblocked option.
• --ffmpeg, -f specify custom FFMPEG arguments (default: -c copy)
  • examples
    • -f="-c copy" -f="-crf 24" -ffmpeg="-vcodec libx264"
    • -f="-vf scale=-1:720"
• --overwrite force overwrite existing files.

Downloading with Softsubs

• --language (same as above) which subtitle languages to download. if omitted, will present a list to select from. same options as below for the languages
  • can be set to none to download no subs
• --mux whether to mux the subtitles into the video. if set to false, a temporary directory with the subtitles and media files is left in the current directory.
• --subsOnly download only the subs, and no video
• --tmpDir where to put the media and subtitle files before muxing

Help

• --help, -h help
• --version, version
• --debug, debug information
• --list, list the episodes of a series (only works with series, will exit after)

Examples

Download an episode with a custom file name

crunchyroll-dl -i https://www.crunchyroll.com/my-hero-academia/episode-1-izuku-midoriya-origin-730707 -u username -p password --unblocked -o ":epname [:resolution]"

Download an entire series

crunchyroll-dl -i https://www.crunchyroll.com/my-hero-academia

Download all seasons without dubs, and only specific episodes

crunchyroll-dl -i https://www.crunchyroll.com/rezero-starting-life-in-another-world- --ignore-dubs --download-all --episodes 1A,1B,2-15

Download an episode with soft subtitles

crunchyroll-dl -i https://www.crunchyroll.com/demon-slayer-kimetsu-no-yaiba/episode-19-hinokami-786932 -u username -p password -s soft --language enUS

Download an episode with all available soft subs, leaving the subs and media files alone (no muxing)

crunchyroll-dl -i https://www.crunchyroll.com/dr-stone/episode-1-stone-world-786941 -u username -p password -s soft --language all --mux=false

Languages

The possible languages are as follows, the default is enUS

enUS - English (US)\ enGB - English (UK)\ esLA - Español\ esES - Español (España)\ ptBR - Português (Brasil)\ ptPT - Português (Portugal)\ frFR - Français (France)\ deDE - Deutsch\ itIT - Italiano\ ruRU - Русский\ arME - العربية

2.0.1

• ffmpeg argument support
  • see README for more info

2.0.0

• Soft sub support
  • The downloader now supports the download of soft-subbed videos or hard-subbed videos
    • Use -s soft while downloading to specify you want soft-subbed videos
    • The videos will begin downloading in a tmp folder. This will be automatically deleted after the download is completed.
      • --noCleanup can be specified to not clean this folder up.
      • --mux can be specified to not mux the files together after download. This will enable --noCleanup as well.
    • Multiple languages can be specified in the --language parameter if using soft subtitles, separated with commas
    • See README.md for examples using these new options
• Fix a bug where the downloader can no longer authenticate with Crunchyroll

1.3.6

• Avert compilation error with the dependencies

1.3.5

• Download without subtitles
  • --language=none
  • This update add an experimental feature which allows you to download the videos without subtitles
    • If this goes well and there is ample demand, I will look into adding softsub functionality to this downloader as well!
• Better automatic quality selection

1.3.4

• Rely on the resolutions provided by CR rather than a hardcoded array
• Slight wording changes
• Update README with --list

1.3.3

• Allow for Dubbed and Dub to be ignored
• Fixed bug with PVs / videos without streams and/or titles

1.3.2

• Hotfix colour

1.3.1

• Add --list
  • Will list all the collections and episodes selected and quit
• Alias --download-all to -a
• Alias --episodes to -e
• Fix a problem with single episodes and --episodes

1.3.0

• --episodes
• --dont-autoselect-quality
• --download-all
• --ignore-dubs
• :series in the output filename for the series name