Skip to main content

A Command-line tool to download manga from MangaDex, written in Python

Project description

pypi-total-downloads python-ver pypi-release-ver

mangadex-downloader

A command-line tool to download manga from MangaDex, written in Python.

Table of Contents

Key Features

  • Download manga, chapter, or list directly from MangaDex
  • Download manga or list from user library
  • Batch download support
  • Old MangaDex url support
  • Scanlation groups filter support
  • Authentication support
  • Control how many chapters and pages you want to download
  • Compressed images support
  • HTTP / SOCKS proxy support
  • Multi languages support
  • Save as raw images, PDF, Comic Book Archive (.cbz) or Tachiyomi local manga

And ability to not download oneshot chapter

Supported formats

Read here for more info.

Installation

What will you need:

That's it.

How to (PyPI)

Installing mangadex-downloader is easy, as long as you have requirements above.

# For Windows
py -3 -m pip install mangadex-downloader

# For Linux / Mac OS
python3 -m pip install mangadex-downloader

You can also install optional dependencies

  • Pillow for PDF support and any single or volume formats
  • py7zr for cb7 support

Or you can install all optional dependencies

# For Windows
py -3 -m pip install mangadex-downloader[optional]

# For Mac OS / Linux
python3 -m pip install mangadex-downloader[optional]

There you go, easy ain't it ?.

How to (bundled executable)

NOTE: This installation only apply to Windows.

Because this is bundled executable, Python are not required to install.

Steps:

How to (Development version)

NOTE: You must have git installed. If you don't have it, install it from here https://git-scm.com/.

git clone https://github.com/mansuf/mangadex-downloader.git
cd mangadex-downloader
python setup.py install

Usage

Command-Line Interface (PyPI version)

mangadex-dl "insert MangaDex URL here" 
# or
mangadex-downloader "insert MangaDex URL here" 

# Use this if "mangadex-dl" or "mangadex-downloader" didn't work

# For Windows
py -3 -m mangadex_downloader "insert MangaDex URL here" 

# For Linux / Mac OS
python3 -m mangadex_downloader "insert MangaDex URL here" 

Command-Line Interface (bundled executable version)

  • Navigate to folder where you downloaded mangadex-downloader
  • Open "start cmd.bat" (don't worry it's not a virus, it will open a command prompt)

example_start_cmd

  • And then start using mangadex-downloader, see example below:
mangadex-dl.exe "insert MangaDex URL here" 

example_usage_executable

For more example usage, you can read here

For more info about CLI options, you can read here

Embedding (API)

from mangadex_downloader import download

download("insert MangaDex URL here")

For more information, you can read here

Notes

Pornographic and erotica content

You may get error You are not allowed to see .. when downloading porn and erotica manga. This is because mangadex-downloader implement strict rule to porn mangas.

For more info, you can see it here

Supporting

Like this project ? Considering give this project a star or donate to the current maintainer @mansuf

The maintainer support these types of donation:

Buy Me a Coffee at ko-fi.com

If you're in Indonesia you can donate with saweria

https://saweria.co/mansuf

Links

Disclaimer

mangadex-downloader are not affiliated with MangaDex. Also, the current maintainer (@mansuf) is not a MangaDex dev

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-downloader-1.2.0.tar.gz (63.0 kB view details)

Uploaded Source

Built Distribution

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

mangadex_downloader-1.2.0-py3-none-any.whl (78.5 kB view details)

Uploaded Python 3

File details

Details for the file mangadex-downloader-1.2.0.tar.gz.

File metadata

  • Download URL: mangadex-downloader-1.2.0.tar.gz
  • Upload date:
  • Size: 63.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for mangadex-downloader-1.2.0.tar.gz
Algorithm Hash digest
SHA256 be3e6083d00092eb9b84cfcd959d72ec0f7818815df891259ff83b7f391e8c8f
MD5 0577ca3fa2ec91cb5d49dadba48fae41
BLAKE2b-256 04b3cdaebade8d88d0bad420024e03dea8bffe4ed267d1b3881fde386529e6f1

See more details on using hashes here.

File details

Details for the file mangadex_downloader-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mangadex_downloader-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 991da914a83dca88e012dd8473a47035885b9005567853ab341c77bf10cdebaf
MD5 7b3736ee04fd6ab9f55b0e5e9e3f7ff6
BLAKE2b-256 37775aa551fb77ce9c21c811a337c485c97f5b40a9e1b60a9756bd4fa6906507

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