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

• 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

• Python 3.7 or higher

Dependencies are automatically installed with pip:

• requests
• tqdm
• questionary

pip install mangadex-dl

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

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

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

This project is available under the MIT License.