Skip to main content

🛸 Mangadex Downloader

command-line tool to download single or multiple manga chapters from mangadex with ease.

🪐 Features

  • Bulk download multiple chapters at once.
  • Choose specific chapters interactively.
  • Supports multiple languages.
  • Saves chapter pages inside a .zip or .cbz archive.
  • Lets you choose archive format (ZIP or CBZ).
  • Automatically sanitizes filenames.
  • Continuous download sessions

🧩 Requirements

  • Python 3.7 or higher

Dependencies are automatically installed with pip:

  • requests
  • tqdm
  • questionary

🚀 Installation

pip install mangadex-dl

🔒 Make sure you have Python 3.7+ and pip installed.

💎 Supported Languages

Code Language
ar Arabic
bg Bulgarian
de German
en English
es Spanish
es-la Spanish (Latin America)
fr French
id Indonesian
it Italian
ko Korean
nl Dutch
pl Polish
pt Portuguese (Portugal)
pt-br Portuguese (Brazil)
ru Russian
tr Turkish
uk Ukrainian
vi Vietnamese
zh Chinese

✨ Usage

Once installed, run the command:

mangadex-dl

You’ll be prompted with two modes:

  • Solo → Download by chapter ID.
  • Bulk → Download by manga ID and select chapters from an interactive list.

You'll also be asked to choose the archive format:

  • zip → A standard ZIP archive.
  • cbz → A ZIP archive with a .cbz extension.

The result will be .zip or .cbz archives containing clean, ordered images of the manga chapter(s).

❓ Example

Solo Mode (Chapter ID):

Enter Chapter ID: 2c580bdd-0b72-4734-8c11-8a47d7525c7f

This will save the chapter as:

chapter-[number]-[lang].zip

Bulk Mode (Manga ID):

Enter Manga ID: d1a9fdeb-f713-407f-960c-8326b586e6fd

It will ask you to select 1 or more languages:

Select Languages:
✔ ar - Arabic
✔ bg - Bulgarian
✔ de - German
✔ en - English
...

You’ll then be asked:

Include NSFW? (Default is No)
  • Select Yes to include mature chapters.
  • Select No to only include safe chapters.

Then select chapters, e.g.:

✔ Chapter 1 [English]
✔ Chapter 1 [Arabic]
✔ Chapter 2 [English]
...

Files will be saved like:

chapter-1-en.zip
chapter-1-ar.zip
chapter-2-en.zip

📜 License

This project is available under the MIT License.

Metadata

Release files for mangadex-dl 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mangadex-dl 0.1.7
File Size Uploaded
mangadex_dl-0.1.7.tar.gz 5.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mangadex-dl 0.1.7
File Interpreter ABI Platform
mangadex_dl-0.1.7-py3-none-any.whl Python 3 none any Details

Total release size: 12.5 kB

Release files / mangadex_dl-0.1.7.tar.gz

Download URL mangadex_dl-0.1.7.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
7ed4dd34256eda46cef256765e9e8a5d97c82511b72dbc96417a059b0a9ba840
BLAKE2b-256 checksum
How to use checksums
5a660957daacafe37e401cdbccba40ee5c17cae6c45c0857868d060b32ca0b1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.14.2

Release files / mangadex_dl-0.1.7-py3-none-any.whl

Download URL mangadex_dl-0.1.7-py3-none-any.whl
Size 6.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
89b24be281fd5b45f692cfdc8d03d6862ab77027749182e21972d078b5662d52
BLAKE2b-256 checksum
How to use checksums
f252ed4176275e86bf990d4a841e6b95dcc97fd9b003bb469629d2d61ac924c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.14.2

Release history Release notifications | RSS feed

This release

0.1.7 This release

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page