Skip to main content

A cli manga downloader

Project description

manga-dlp - python script to download mangas

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

CI/CD

status-badge Last Release Version Version PyPi

Code Analysis

Quality Gate Status Coverage Bugs Security

Meta

Code style Linter Types Imports Tests Coverage License Compatibility

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

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

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

manga_dlp-2.1.16.tar.gz (15.5 kB view details)

Uploaded Source

Built Distribution

manga_dlp-2.1.16-py3-none-any.whl (17.4 kB view details)

Uploaded Python 3

File details

Details for the file manga_dlp-2.1.16.tar.gz.

File metadata

  • Download URL: manga_dlp-2.1.16.tar.gz
  • Upload date:
  • Size: 15.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.23.0

File hashes

Hashes for manga_dlp-2.1.16.tar.gz
Algorithm Hash digest
SHA256 feae515cbac275fd68a5fc1a0099efa8833c25f07ece82254eef5bb2e71abbb6
MD5 8ea4f187480d965f4ae77bf5fe7e6d5d
BLAKE2b-256 b013beabcbd4bb50dfdb094ccfed739a8ab8e699657e0b01c3546446fdac8e88

See more details on using hashes here.

File details

Details for the file manga_dlp-2.1.16-py3-none-any.whl.

File metadata

  • Download URL: manga_dlp-2.1.16-py3-none-any.whl
  • Upload date:
  • Size: 17.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.23.0

File hashes

Hashes for manga_dlp-2.1.16-py3-none-any.whl
Algorithm Hash digest
SHA256 893046bc9b9dd0db4e058c63c49d33ef9139f8ee03243033c72cfc69784b10e2
MD5 a7e39cbbbcae9a3ef45ae30dc6358e9a
BLAKE2b-256 b93083a672e5a3d2058258c9b41d3356540e2fc1ad0c1e9849ecefeb09a2b8a8

See more details on using hashes here.

Supported by

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