Skip to main content

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

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mangadex_dl-0.1.7.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mangadex_dl-0.1.7-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file mangadex_dl-0.1.7.tar.gz.

File metadata

  • Download URL: mangadex_dl-0.1.7.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.14.2

File hashes

Hashes for mangadex_dl-0.1.7.tar.gz
Algorithm Hash digest
SHA256 7ed4dd34256eda46cef256765e9e8a5d97c82511b72dbc96417a059b0a9ba840
MD5 51fd7c5de865c7f57bb14f8b2aad8132
BLAKE2b-256 5a660957daacafe37e401cdbccba40ee5c17cae6c45c0857868d060b32ca0b1f

See more details on using hashes here.

File details

Details for the file mangadex_dl-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: mangadex_dl-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 6.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.14.2

File hashes

Hashes for mangadex_dl-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 89b24be281fd5b45f692cfdc8d03d6862ab77027749182e21972d078b5662d52
MD5 56be866f418c22c8f342a13e0c1ae009
BLAKE2b-256 f252ed4176275e86bf990d4a841e6b95dcc97fd9b003bb469629d2d61ac924c2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page