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.
  • 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.6.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.6-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mangadex_dl-0.1.6.tar.gz
  • Upload date:
  • Size: 5.9 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.6.tar.gz
Algorithm Hash digest
SHA256 769d9cb5d291440fdd4f6aeaf47ecbf1dcad6f1575ab6dd67d7dfe3f0133ea4f
MD5 e158257c86d128574799f70ae49eea01
BLAKE2b-256 60e292d92f18697173f5b33a85829deacd072262b4398fa569bf49b71e315b4f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mangadex_dl-0.1.6-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.13.7

File hashes

Hashes for mangadex_dl-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 fdb165d9e565232c768b523a5ec3311f56149e8d096277f366c860a7d2ea54d8
MD5 788a916c30171a0f62c70b2787d6d14d
BLAKE2b-256 ff79db08cf00301ec9b7eeb11d9a3d0abed2a5ab2826e50768e8d3bd9e97f1ed

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