manga-dlp
python script to download mangas
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 archvie. If you just want the folder with all the pictures use the flag --nocbz.
Currently Supported sites
Usage
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)
(not yet done)
With docker
See the docker README
Options
usage: manga-dlp.py [-h] [-u URL] [-c CHAPTERS] [-p PATH] [-l LANG] [--read READ] [--list] [--nocbz] [--forcevol] [--wait WAIT]
[--verbose]
optional arguments:
-h, --help Show this help message and exit
-u URL, --url URL URL of the manga
-c CHAPTERS, --chapters CHAPTERS Chapters to download
-p PATH, --path PATH Download path. Defaults to "
/downloads"
-l LANG, --language LANG Manga language. Defaults to "en" --> english
--read READ Path of file with manga links to download. One per line
--list List all available chapters. Defaults to false
--nocbz Dont pack it to a cbz archive. Defaults to false
--forcevol Force naming of volumes. For mangas where chapters reset each volume
--wait WAIT Time to wait for each picture to download in seconds(float). Defaults 0.5
--verbose Verbose logging. Defaults to false
Downloads file-structure
.
└──
/
└──
/
└──
/
Example:
./downloads/mangatitle/chaptertitle(.cbz)
Read list of links from file
With the option --read you can specify a file with links to multiple mangas. They will be parsed from top to bottom one at a time. Every link will be matched for the right api to use. It is important that you only have one link per line, otherwise they can't be parsed.
Example:
# mangas.txt
link1
link2
link3
python3 manga-dlp.py --read mangas.txt --list
This will list all available chapters for link1, link2 and link3.
Set download path
With the option -p/--path you can specify a path to download the chapters to. The default path is
. Absolute and relative paths are supported.
Example:
python3 manga-dlp.py
This will save all mangas/chapters in the path /media/mangas/
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.
Otherwise you can open a 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 a issue with a description of the problem.
TODO's
Make docker container for easy distribution--> Dockerhub- Make pypi package
- Add more supported sites
33 Jan 3, 2023
106 Jan 7, 2023
72 Dec 20, 2022
16 Dec 12, 2022
715 Jan 6, 2023
9 Sep 4, 2022
8 Jul 9, 2022
1.6k Apr 12, 2022
6 Dec 29, 2022
![[FEATURE] Volume support for all apis (future proofing)](https://avatars.githubusercontent.com/u/97067423?v=4)
2.7k Dec 31, 2022
91 Dec 28, 2022
17 Aug 10, 2022
208 Jan 4, 2023
2 Aug 18, 2022
2 Nov 17, 2021
1 Nov 18, 2021
1 Dec 3, 2021
23 Dec 3, 2022
1 Mar 30, 2022