A command-line tool to download manga from MangaDex, written in Python.
Key Features
Supported formats
Installation
Python Package Index (PyPI)
Bundled executable
Docker
Development version
Usage
PyPI version
Bundled executable version
Docker version
Contributing
Donation
Support
Links
Disclaimer
Download manga, cover manga, chapter, or list directly from MangaDex
Download manga or list from user library
Find and download MangaDex URLs from MangaDex forums (https://forums.mangadex.org/)
Batch download support
Legacy MangaDex url support
Scanlation groups filter support
Authentication support
Control how many chapters and pages you want to download
Compressed images support
HTTP / SOCKS proxy support
DNS-over-HTTPS support
Multi languages support
Save as raw images, EPUB, PDF, Comic Book Archive (.cbz or .cb7)
And ability to not download oneshot chapter
Read here for more info.
What will you need:
Python 3.8.x or up with Pip (if you are in Windows, you can download bundled executable. See this instructions how to install it)
That's it.
Installing mangadex-downloader is easy, as long as you have requirements above.
# For Windowspy -3 -m pip install mangadex-downloader# For Linux / Mac OSpython3 -m pip install mangadex-downloader
You can also install optional dependencies
py7zr for cb7 support
orjson for maximum performance (fast JSON library)
lxml for EPUB support
Or you can install all optional dependencies
# For Windowspy -3 -m pip install mangadex-downloader[optional]# For Mac OS / Linuxpython3 -m pip install mangadex-downloader[optional]
There you go, easy ain't it ?.
NOTE: This installation only apply to Windows.
Because this is bundled executable, Python are not required to install.
Steps:
Download latest version here -> https://github.com/mansuf/mangadex-downloader/releases
Extract it.
That's it ! You have successfully install mangadex-downloader. See this instructions to run mangadex-downloader
Available at:
https://hub.docker.com/r/mansuf/mangadex-downloader
https://gallery.ecr.aws/mansuf/mangadex-downloader
# Dockerhubdocker pull mansuf/mangadex-downloader# AWS ECR (Alternative)docker pull public.ecr.aws/mansuf/mangadex-downloader
If you want to get optional features such as EPUB
support, cb7
support, etc.
You can use tag ending with -optional
# Dockerhubdocker pull mansuf/mangadex-downloader:latest-optional docker pull mansuf/mangadex-downloader:v2.10.3-optional# AWS ECR (Alternative)docker pull public.ecr.aws/mansuf/mangadex-downloader:latest-optional docker pull public.ecr.aws/mansuf/mangadex-downloader:v2.10.3-optional
NOTE: If you're wondering why optional tags doesn't have arm/v6 platform support.
That's because some dependencies (most notably orjson
) require rust compiler
and i give up installing rust compiler in arm/v6 platform, there is too much errors for me.
NOTE: You must have git installed. If you don't have it, install it from here https://git-scm.com/.
git clone https://github.com/mansuf/mangadex-downloader.gitcd mangadex-downloader python setup.py install # or "pip install ."
mangadex-dl "insert MangaDex URL here" # ormangadex-downloader "insert MangaDex URL here" # Use this if "mangadex-dl" or "mangadex-downloader" didn't work# For Windowspy -3 -m mangadex_downloader "insert MangaDex URL here" # For Linux / Mac OSpython3 -m mangadex_downloader "insert MangaDex URL here"
Navigate to folder where you downloaded mangadex-downloader
Open "start cmd.bat" (don't worry it's not a virus, it will open a command prompt)
And then start using mangadex-downloader, see example below:
mangadex-dl.exe "insert MangaDex URL here"
The downloaded files in the container are stored in /downloads
directory
# Dockerhubdocker run --rm -v /home/sussyuser/sussymanga:/downloads mansuf/mangadex-downloader "insert MangaDex URL"# AWS ECR (alternative)docker run --rm -v /home/sussyuser/sussymanga:/downloads public.ecr.aws/mansuf/mangadex-downloader "insert MangaDex URL"
For more example usage, you can read here
For more info about CLI options, you can read here
See CONTRIBUTING.md for more info
If you like this project, please consider donate to one of these websites:
Sociabuzz
Ko-fi
Github Sponsor
Any donation amount will be appreciated ?
Need help ? Have questions or you just wanna chat ?
Come join to discord server
Please note, that the Discord server is really new and it doesn't have anything on it. So please be respect and kind.
PyPI
Docs
Discord Server (Mostly for questions and support)
mangadex-downloader are not affiliated with MangaDex. Also, the current maintainer (@mansuf) is not a MangaDex dev