Usage#
Download manga, cover manga, chapter or list#
# Manga
mangadex-dl "https://mangadex.org/title/..."
# Cover manga
mangadex-dl "https://mangadex.org/covers/..."
# Chapter
mangadex-dl "https://mangadex.org/chapter/..."
# List
mangadex-dl "https://mangadex.org/list/..."
# Or you can just give the id
mangadex-dl "a96676e5-8ae2-425e-b549-7f15dd34a6d8"
Warning
If you want to download private list and you own that list, you must login by using --login option. Otherwise
you will get error “List … cannot be found”
mangadex-dl "https://mangadex.org/list/..." --login
# You will be prompted to input (username or email) and password
mangadex-downloader also support old MangaDex url
# Old manga url
mangadex-dl "https://mangadex.org/title/123"
# Old chapter url
mangadex-dl "https://mangadex.org/chapter/34"
Warning
Old MangaDex url only support full URL, not just the id. If you just provide old id, it will not work.
For example
# This will work
mangadex-dl "https://mangadex.org/title/34"
# This will NOT work
mangadex-dl "34"
Download from a forums thread#
mangadex-dl "https://forums.mangadex.org/threads/..."
# An example
mangadex-dl "https://forums.mangadex.org/threads/whats-your-top-3-manga.1082493/"
For more info, you can see it here -> Forums
Batch download#
mangadex-downloader support batch downloading. Just type a file and you’re good to go !.
Make sure contents of the file are list of MangaDex urls
# Inside of `urls.txt` file
https://mangadex.org/title/manga_id
https://mangadex.org/chapter/chapter_id
https://mangadex.org/list/list_id
Example usage:
mangadex-dl "insert a file here"
Warning
If you give invalid path to file that containing MangaDex urls, the app will see it as URL. See example below
# Not valid path
$ mangadex-dl "not-exist-lol/lmao.txt"
# error: argument URL: Invalid MangaDex URL or manga id
# valid path
$ mangadex-dl "yes-it-exist/exist.txt"
# ...
Download manga, chapter or list in different format#
mangadex-downloader support download manga as different format. For more info about supported formats, you can see it here -> Supported formats
By default, mangadex-downloader will download in raw format.
Which just a bunch of images stored in each chapter folder. You can use different format by using --save-as option.
# Save as .pdf
mangadex-dl "https://mangadex.org/title/..." --save-as pdf
# Save as .cbz
mangadex-dl "https://mangadex.org/title/..." --save-as cbz
# Save as raw
mangadex-dl "https://mangadex.org/title/..." --save-as raw
Search a manga and then download it#
mangadex-downloader support search and download. You can use it by adding --search option.
mangadex-dl "komi san" --search
# Output:
# =============================
# Search results for "komi san"
# =============================
# (1). ...
# (2). ...
# (3). ...
# (4). ...
# (5). ...
# (6). ...
# (7). ...
# (8). ...
# (9). ...
# (10). ...
# type "next" to show next results
# type "previous" to show previous results
# =>
# ...
Download manga, chapter, or list in different translated language#
By default, the app will download in English language.
To view all available languages, use --list-languages option.
mangadex-dl --list-languages
# ...
An example downloading a manga in Indonesian language.
mangadex-dl "https://mangadex.org/title/..." --language "id"
mangadex-dl "https://mangadex.org/title/..." --language "Indonesian"
File management#
mangadex-downloader support store in different path / folder.
mangadex-dl "https://mangadex.org/title/..." --folder "insert directory here"
# or
mangadex-dl "https://mangadex.org/title/..." --path "insert directory here"
# or
mangadex-dl "https://mangadex.org/title/..." -d "insert directory here"
It also support replace existing manga, chapter or list
mangadex-dl "https://mangadex.org/title/..." --replace
Also, you can add chapter title for each folder.
mangadex-dl "https://mangadex.org/title/..." --use-chapter-title
By default, mangadex-downloader will add scanlator group name for each chapter folder.
If you don’t want this, use --no-group-name option
mangadex-dl "https://mangadex.org/title/..." --no-group-name
Chapters and pages range#
mangadex-downloader support download manga with specified range chapters and pages
# This will download chapters from 20 to 69
mangadex-dl "https://mangadex.org/title/..." --start-chapter 20 --end-chapter 69
# This will download chapters from 20 to 69 and pages from 5 to 20
mangadex-dl "https://mangadex.org/title/..." --start-chapter 20 --end-chapter 69 --start-page 5 --end-page 20
Warning
If you use --start-page and --end-page when downloading manga it will download all chapter with specified range pages
You can use --start-page and --end-page too when downloading a chapter
mangadex-dl "https://mangadex.org/chapter/..." --start-page 5 --end-page 20
Warning
You can’t use these options when downloading a list. If you’re trying to do that, it will throw a error.
mangadex-dl "https://mangadex.org/list/..." --start-chapter 20 --end-chapter 69
# Output: [ERROR] --start-chapter is not allowed when download a list
By default, oneshot chapter are downloaded. If you don’t want download oneshot chapter, use --no-oneshot-chapter.
Example usage:
mangadex-dl "https://mangadex.org/title/..." --no-oneshot-chapter
Manga cover#
# Download manga with original quality cover (the default)
mangadex-dl "https://mangadex.org/title/..." --cover "original"
# 512px quality
mangadex-dl "https://mangadex.org/title/..." --cover "512px"
# 256px quality
mangadex-dl "https://mangadex.org/title/..." --cover "256px"
# No cover
mangadex-dl "https://mangadex.org/title/..." --cover "none"
Login to MangaDex#
You can download private list and manga from your library if you logged in.
mangadex-dl "https://mangadex.org/list/..." --login
# MangaDex username / email => "insert MangaDex username or email here"
# MangaDex password => "insert MangaDex password here"
# [INFO] Logging in to MangaDex
# [INFO] Logged in to MangaDex
# ...
You can specify (username or email) and password without be prompted (less secure) !
using --login-username and --login-password
mangadex-dl "https://mangadex.org/title/..." --login --login-username "..." --login-password "..."
# [INFO] Logging in to MangaDex
# [INFO] Logged in to MangaDex
# ...
Choose and download random manga#
In case you wanna try something different, this feature is for you !
Example usage:
mangadex-dl "random"
it also support content ratings filter
mangadex-dl "random:safe, suggestive"
For more information, see Random manga
Download seasonal manga#
Trying to see something good in this season ?
mangadex-dl "seasonal"
For more information, see Seasonal manga
Update mangadex-downloader#
mangadex-dl --update