Reference

App names

There is few app names in mangadex-downloader:

• mangadex-dl

• mangadex-downloader

Note

If none of above doesnt work use this

# For Windows
py -3 -m mangadex_downloader

# For Linux
python3 -m mangadex_downloader

Note

For bundled executable will remain mangadex-dl

Options

Global options

URL

MangaDex URL or a file containing MangaDex URLs. Type library:<status> to download manga from logged in user library, if <status> is provided, it will fetch all mangas with given reading status, if not, then it will fetch all mangas from logged in user. Type list:<user_id> to download MangaDex list user, if <user_id> is provided it will download public list, if not, then it will download from public and private list from logged in user. Type followed-list to download followed MangaDex list from logged in user

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

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

--folder --path -d FOLDER

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

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

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

If manga has oneshot chapter, it will be ignored

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

--no-chapter-info -nci

Warning

Deprecated, chapter info creation are disabled by default. Use --use-chapter-info to enable chapter info creation

Do nothing. Previously, it was used to disable creation of chapter info for any single and volume formats

--use-chapter-cover -ucc

Note

Chapter info creation are not enabled if you are using any chapter format (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 NUM_PAGE

Start download chapter page from given page number

--end-page -ep NUM_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

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)

-pipe

If set, the app will accept pipe input

-v --version

Print mangadex-downloader version

-npb --no-progress-bar

Disable progress bar when downloading or converting

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

Update application

--update

Update mangadex-downloader to latest version

Available commands

Example usage

mangadex-dl "random"

List of commands

random

Show 5 of random manga and select to download

For more info, see Random manga

library

Show list of saved manga from logged in user

For more info, see Manga library command

list

Show list of saved MDLists from logged in user

For more info, see List library command

followed-list

Show list of followed MDLists from logged in user

For more info, see Followed list library command

group

Show list of manga from a group that have uploaded scanlated chapters

file

Download list of manga, chapters or lists from a file

For more info, see File command (batch download command)

seasonal

Select and download seasonal manga

For more info, see Seasonal manga

conf

Modify or show config

For more info, see Configuration

login_cache

Modify or show cached authentication tokens expiration time

For more info, see Authentication cache

Reference

• Cover command
  • Syntax
  • Example usage
• File command (batch download command)
  • Syntax
  • Arguments
  • Example usage
• Forums
  • Specific post in a forum thread
  • Legacy MangaDex forum thread URL
  • Note
• Download tracker
  • Wait isn’t that same behaviour as previous one ?
  • Verify downloaded chapters and images
  • Cool features, is there a way to turn it off ?
• Chapter info (cover)
• Filters
  • Syntax
  • Available filters
  • Example usage
• Random manga
  • Syntax
  • Example usage
• Manga library command
  • Syntax
  • Statuses
  • Example usage
• List library command
  • Syntax
  • Example usage
• Followed list library command
  • Syntax
  • Example usage
• Seasonal manga
  • Syntax
  • Example usage
• Configuration
  • Syntax
  • Environment variables
  • Available configs
  • Example usage
• Authentication cache
  • Syntax command
  • Available sub commands
  • Example usage commands
• Environment variables