Skip to main content

A sleek CLI tool to download single or multiple manga chapters from MangaDex with ease.

Project description

🛸 Mangadex Downloader

A sleek CLI 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.

🧩 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.5.tar.gz (5.8 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.5-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mangadex_dl-0.1.5.tar.gz
Algorithm Hash digest
SHA256 ea682b5f669ec46da8def911ab36d30974a98ac6d86195120a345bbef0cd0e14
MD5 b2ef77d1e6048f898a0b93f4a10eb18c
BLAKE2b-256 1c301aa41a12a887a4753af3b44b1d0bf0d64a2f7578a929979392dabb1b1a55

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for mangadex_dl-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 6f3399d664209ba1563a247d1dc373a2c6c3b47262b45b4ee230d15788cd58ca
MD5 f240f8bb6b45563238788a63b90825a3
BLAKE2b-256 bd3687bdf31aff99c65ec0cceaffbc3c4b1215b8ea02ebbe0d58fc9cf98a0b0b

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