Comic/manga/webtoon downloader and converter to CBZ/EPUB/PDF
Project description
mandown
Comic downloader and converter to CBZ, EPUB, and/or PDF as a Python library and command line application.
Supported sites
To request a new site, please file a new issue.
- https://mangasee123.com
- https://manganato.com
- https://webtoons.com
- https://mangadex.org
- https://mangakakalot.com
- https://readcomiconline.li
Installation
Install the package from PyPI:
pip3 install mandown
Install the optional large dependencies for some features of Mandown:
# image processing
pip3 install Pillow
# graphical interface (GUI)
pip3 install PySide6
Arch Linux users may also install the package from the AUR:
git clone https://aur.archlinux.org/mandown-git.git
makepkg -si
Or, to build from source:
Mandown depends on poetry for building.
git clone https://github.com/potatoeggy/mandown.git
poetry install
poetry build
pip3 install dist/mandown*.whl
Usage
mandown get <URL>
To convert the download contents to CBZ/EPUB, append the --convert
option. To apply image processing to the downloaded images, append the --process
option.
mandown get <URL> --convert epub --process rotate_double_pages
To convert an existing folder without downloading anything except metadata (like a stripped-down version of https://github.com/ciromattia/kcc), use the convert
command.
mandown convert <FORMAT> <PATH_TO_FOLDER>
Run mandown --help
for more info.
Library usage
import mandown
# load a previously downloaded comic...
comic = mandown.load("path/to/comic/folder")
print(comic.metadata, comic.chapters)
# ...OR fetch a comic from a source by URL
comic = mandown.query(url_to_comic)
print(comic.metadata, comic.chapters)
# download comic to ./comic using 4 threads
mandown.download(comic, "./comic/", threads=4)
# apply image post-processing to comic images in ./comic
mandown.process("./comic/", options=["rotate_double_pages", "trim_borders"])
# convert comic located in ./comic to epub, storing it in ./epubs
mandown.convert(comic, "./comic/", "epub", "./epubs")
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.