4.2.0 • Published 4 years ago

mai-dl v4.2.0

Weekly downloads
7
License
MIT
Repository
github
Last release
4 years ago

mai-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 mai-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.

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

mai-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

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

Download all seasons without dubs, and only specific episodes

mai-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

mai-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)

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