Command-line Interface (CLI) options

Global options

URL

MangaDex URL or a file containing MangaDex URLs. This parameter also can be used for commands, to see all available commands see Commands

--type -t manga|cover|list|chapter|legacy-manga|legacy-chapter

Override type MangaDex url. By default, it auto detect given url

--folder --path -d DIRECTORY

Store manga in given folder / directory

--replace -r

Replace manga, chapter, or list (if exist)

--filter -ft

Apply filter to search and random manga

For more information, see Filters

--download-mode -dm

Set download mode, you can set to default or unread. If you set to unread, the app will download unread chapters only (require authentication). If you set to default the app will download all chapters

--verbose

Warning

This option is deprecated and will be removed in v3.0.0. Use --log-level with value DEBUG instead.

Enable verbose output

Search related

--search -s

Search a manga and then download it

Manga related

--use-alt-details -uad

Use alternative title and description manga

Group related

--group -g GROUP_ID

Filter each chapter with different scanlation group. Filter with user also supported.

Language related

--language -lang LANGUAGE

Download manga in given language, to see all languages, use --list-languages option

--list-language -ll

List all available languages

--volume-cover-language -vcl LANGUAGE

Override volume cover language. If this option is not set, it will follow --language option

Chapter related

--start-chapter -sc CHAPTER

Start download chapter from given chapter number

--end-chapter -ec CHAPTER

Stop download chapter from given chapter number

--no-oneshot-chapter -noc

Ignore oneshot chapter (if manga has oneshot chapter)

--no-group-name -ngn

Do not use scanlation group name for each chapter

--use-chapter-title -uct

Use chapter title for each chapters.

Note

This option is useless if used with any single and volume format

--use-chapter-cover -ucc

Note

Chapter info creation are not enabled if you are using any chapter formats (cbz, pdf, raw, etc)

Enable creation of chapter info (cover) for any single or volume formats. See Chapter info (cover) for more info.

--use-volume-cover -uvc

Note

Volume cover will be not created in chapter (cbz, pdf, raw, etc) and single formats

Enable creation of volume cover for any volume formats. Volume cover will be placed in first page in each volume files.

--sort-by

Download sorting method, by default it’s selected to volume

Chapter page related

--start-page -sp PAGE

Start download chapter page from given page number

--end-page -ep PAGE

Stop download chapter page from given page number

Chapter and page range

--range -rg

Warning

This option can only be used for downloading manga. Downloading a list or chapter while using this option will throw an error.

A range pattern to download specific chapters

Images related

--use-compressed-image -uci

Use low size images manga (compressed quality)

--cover -c original|512px|256px|none

Choose quality cover, default is original

Authentication related

--login -l

Login to MangaDex

--login-method -lm legacy|oauth2

Set authentication method for MangaDex, by default it set to legacy. Which is directly input (username or email) and password to the application.

--login-username -lu USERNAME

Note

You must provide --login or -l option to login. If you don’t, you will not logged in to MangaDex

Login to MangaDex with username or email (you will be prompted to input password if –login-password are not present).

--login-password -lp PASSWORD

Note

You must provide --login or -l option to login. If you don’t, you will not logged in to MangaDex

Login to MangaDex with password (you will be prompted to input username if –login-username are not present).

--login-cache -lc

Note

Using this option can cause an attacker in your computer may grab your authentication cache and using it for malicious actions. USE IT WITH CAUTION !!!

Cache authentication token. You don’t have to re-login with this option. You must set MANGADEXDL_CONFIG_ENABLED=1 in your environment variables before doing this, otherwise the app will throwing error.

Save as format

--save-as -f raw|raw-volume|raw-single|tachiyomi|tachiyomi-zip|pdf|pdf-volume|pdf-single|cbz|cbz-volume|cbz-single|cb7|cb7-volume|cb7-single

Choose save as format, default to raw. For more information about formats, see Supported formats

Network related

--proxy -p SOCKS / HTTP Proxy

Set http/socks proxy

--proxy-env -pe

use http/socks proxy from environments

--force-https -fh

Force download images in standard HTTPS port 443

--delay-requests -dr DELAY_TIME

Set delay for each requests send to MangaDex server

--dns-over-https -doh PROVIDER

Enable DNS-over-HTTPS (DoH), must be one of cloudflare or google

--timeout TIME_IN_SECONDS

Set timeout for each HTTPS(s) requests

--http-retries NUMBERS_OR_UNLIMITED

Set HTTP retries, use this if you want to set how much to retries if the app failed to send HTTP requests to MangaDex API. Value must be numbers or “unlimited”, by default it set to 5

Miscellaneous

--input-pos

Automatically select choices in selectable prompt (list, library, followed-list command)

Note

This option does not apply to --use-alt-details

-pipe

If set, the app will accept pipe input

-v --version

Print mangadex-downloader version

--no-track

Note

If you enable this, the application will not verify images and chapters. Also file download.db will not created.

Disable download tracking

Console output

--log-level LEVEL

Set logger level, available options: CRITICAL, ERROR, WARNING, INFO, DEBUG, NOTSET. Default level is INFO.

For more information, see Logging levels

-pbl --progress-bar-layout LAYOUT

Set progress bar layout, available options: default, stacked, none. Default layout is default. Set layout none to disable progress bar.

-spb-order --stacked-progress-bar-order ORDER

Set stacked progress bar order, available options: volumes, chapters, pages, file sizes, convert. Multiple values is supported, separated by comma. Default order is volumes, chapters, pages, file sizes, convert

-npb --no-progress-bar

Warning

This option is deprecated and will be removed in v3.0.0. Use --progress-bar-layout with value none instead

Disable progress bar when downloading or converting

Update application

--update

Update mangadex-downloader to latest version