mangadex-downloader

mangadex-downloader

A command-line tool to download manga from MangaDex, written in Python.

Table of Contents

• 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

Key Features

• 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/)
• Download manga in each chapters, each volumes, or wrap all chapters into single file
• Search (with filters) and download manga
• Filter chapters with scalantion groups or users
• Manga tags, groups, and users blacklist support
• Batch download support
• Authentication (with cache) support
• Control how many chapters and pages you want to download
• Multi languages support
• Legacy MangaDex url support
• Save as raw images, EPUB, PDF, Comic Book Archive (.cbz or .cb7)
• Respect API rate limit

And ability to not download oneshot chapter

Supported formats

Read here for more info.

Installation

What will you need:

• Python 3.10.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.

Python Package Index (PyPI)

Installing mangadex-downloader is easy, as long as you have requirements above.

# For Windows
py -3 -m pip install mangadex-downloader

# For Linux / Mac OS
python3 -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 Windows
py -3 -m pip install mangadex-downloader[optional]

# For Mac OS / Linux
python3 -m pip install mangadex-downloader[optional]

There you go, easy ain't it ?.

Bundled executable

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

Docker

Available at:

• https://hub.docker.com/r/mansuf/mangadex-downloader
• https://gallery.ecr.aws/mansuf/mangadex-downloader

# Dockerhub
docker 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

# Dockerhub
docker pull mansuf/mangadex-downloader:latest-optional
docker pull mansuf/mangadex-downloader:v3.1.4-optional

# AWS ECR (Alternative)
docker pull public.ecr.aws/mansuf/mangadex-downloader:latest-optional
docker pull public.ecr.aws/mansuf/mangadex-downloader:v3.1.4-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.

Development version

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.git
cd mangadex-downloader
python setup.py install # or "pip install ."

Usage

PyPI version

mangadex-dl "insert MangaDex URL here" 
# or
mangadex-downloader "insert MangaDex URL here" 

# Use this if "mangadex-dl" or "mangadex-downloader" didn't work

# For Windows
py -3 -m mangadex_downloader "insert MangaDex URL here" 

# For Linux / Mac OS
python3 -m mangadex_downloader "insert MangaDex URL here" 

Bundled executable version

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

Docker version

The downloaded files in the container are stored in /downloads directory

# Dockerhub
docker 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

Contributing

See CONTRIBUTING.md for more info

Donation

If you like this project, please consider donate to one of these websites:

• Sociabuzz
• Ko-fi
• Github Sponsor

Any donation amount will be appreciated 💖

Support

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.

Links

• PyPI
• Docs
• Discord Server (Mostly for questions and support)

Disclaimer

mangadex-downloader are not affiliated with MangaDex. Also, the current maintainer (@mansuf) is not a MangaDex dev