manga-dlp - python script to download mangas

Full docs: https://manga-dlp.ivn.sh

CI/CD

Code Analysis

Meta

Description

A manga download script written in python. It only supports mangadex.org for now. But support for other sites is planned.

Before downloading a new chapter, the script always checks if there is already a chapter with the same name in the download directory. If found the chapter is skipped. So you can run the script on a schedule to only download new chapters without any additional setup.

The default behaiviour is to pack the images to a cbz archive. If you just want the folder with all the pictures use the flag --nocbz.

Currently Supported sites

• Mangadex.org

Usage

Quick start

python3 manga-dlp.py \
          --url https://mangadex.org/title/a96676e5-8ae2-425e-b549-7f15dd34a6d8/komi-san-wa-komyushou-desu \
          --language "en" \
          --chapters "all"

With GitHub

git clone https://github.com/olofvndrhr/manga-dlp.git # clone the repository

cd manga-dlp # go in the directory

pip install -r requirements.txt # install required packages

# on windows
python manga-dlp.py <options>
# on unix
python3 manga-dlp.py <options>

With pip (pypi)

python3 -m pip install manga-dlp # download the package from pypi

python3 -m mangadlp <args> # start the script as a module
OR
manga-dlp <args> # call script directly
OR
mangadlp <args> # call script directly

With docker

See the docker README

Options

Usage: manga-dlp.py [OPTIONS]

Script to download mangas from various sites

Options:
--help                          Show this message and exit.
--version                       Show the version and exit.

source: [mutually_exclusive, required]
-u, --url, --uuid TEXT          URL or UUID of the manga
--read FILE                     Path of file with manga links to download. One per line

verbosity: [mutually_exclusive]
--loglevel INTEGER              Custom log level  [default: 20]
--warn                          Only log warnings and higher
--debug                         Debug logging. Log EVERYTHING

-c, --chapters TEXT             Chapters to download
-p, --path PATH                 Download path  [default: downloads]
-l, --language TEXT             Manga language  [default: en]
--list                          List all available chapters
--format TEXT                   Archive format to create. An empty string means dont archive the folder  [default: cbz]
--forcevol                      Force naming of volumes. For mangas where chapters reset each volume
--wait FLOAT                    Time to wait for each picture to download in seconds(float)  [default: 0.5]
--hook-manga-pre TEXT           Commands to execute before the manga download starts
--hook-manga-post TEXT          Commands to execute after the manga download finished
--hook-chapter-pre TEXT         Commands to execute before the chapter download starts
--hook-chapter-post TEXT        Commands to execute after the chapter download finished

Contribution / Bugs

For suggestions for improvement, just open a pull request.

If you want to add support for a new site, there is an api template file which you can use. And more infos and tools in the contrib README.md

Otherwise, you can open am issue with the name of the site which you want support for. (not guaranteed to be implemented)

If you encounter any bugs, also just open an issue with a description of the problem.

TODO's

• Make docker container for easy distribution --> Dockerhub
• Automate release --> Done with woodpecker-ci
• Make pypi package --> Done with release 2.1.7
• Add more supported sites