A fast, modern, and beautiful Crunchyroll downloader.


Keywords
anime, crunchyroll, download
License
MIT
Install
npm install crunchyroll-dl@2.0.1

Documentation

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

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 - العربية