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.

Key Features

  • Download manga, chapter, or list directly from MangaDex
  • 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

mangadex-downloader can download in different formats, here a list of supported formats.

  • raw
  • raw-volume
  • raw-single
  • tachiyomi
  • tachiyomi-zip
  • pdf
  • pdf-volume
  • pdf-single
  • cbz
  • cbz-volume
  • cbz-single

For more info about supported formats, you can read here

Installation

What will you need:

  • Python 3.8.x or up with Pip (if you are in Windows, you can download bundled executable here)

That's it.

How to (PyPI)

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

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

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

You can also install optional dependencies

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

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

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.0.1.tar.gz (45.0 kB view hashes)

Uploaded Source

Built Distribution

mangadex_downloader-1.0.1-py3-none-any.whl (56.0 kB view hashes)

Uploaded Python 3

Supported by

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