mandown
Mandown is a comic downloader and a CBZ, EPUB, MOBI, and/or PDF converter. It also supports image post-processing to make them more readable on certain devices similarly to Kindle Comic Converter.
Features
- Download comics from supported sites
- Supports downloading a range of chapters
- Supports multithreaded downloading
- Process downloaded images
- Rotate or split double-page spreads
- Trim borders
- Resize images
- Convert downloaded comics to CBZ, EPUB, MOBI, or PDF
- Convert any other CBZ, EPUB, MOBI, or PDF comic to CBZ, EPUB, MOBI, or PDF
- A library to easily do all of this from other Python scripts
Usage
Run mandown --help or see the docs for more information and examples.
mandown get <URL>
To convert the downloaded contents to CBZ/EPUB/MOBI/PDF, 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 download only a certain range of chapters, append the --start and/or --end options.
Note:
--startand--endare inclusive, i.e., using--start 2 --end 3will download chapters 2 and 3.
To convert an existing folder or comic file without downloading anything (like a stripped-down version of https://github.com/ciromattia/kcc), use the convert command.
mandown convert <FORMAT> <PATH_TO_COMIC>
To process an existing folder without downloading anything, use the process command.
mandown process <PROCESS_OPERATIONS> <PATH_TO_FOLDER>
Where PROCESS_OPERATIONS is an option found from running mandown process --help.
Installation
Install the package from PyPI:
pip3 install mandown
Install the optional large dependencies for some features of Mandown:
# 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 uses poetry for dependency management.
git clone https://github.com/potatoeggy/mandown.git
poetry install
poetry build
pip3 install dist/mandown*.whl
Supported sites
To request a new site, please file a new issue.
- https://bato.to
- https://comicfury.com
- https://*.thecomicseries.com
- https://natomanga.com
- https://webtoons.com
- https://mangadex.org
- https://readcomiconline.li
- https://www.kuaikanmanhua.com
Basic library usage
See the docs for more information and examples.
To just download the images:
import mandown
mandown.download("https://comic-site.com/the-best-comic")
To download and convert to EPUB:
import mandown
comic = mandown.query("https://comic-site.com/the-best-comic")
mandown.download(comic)
mandown.convert(comic, title=comic.metadata.title, to="epub")
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mandown-1.12.2.tar.gz.
File metadata
- Download URL: mandown-1.12.2.tar.gz
- Upload date:
- Size: 41.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.1.3 CPython/3.13.5 Darwin/24.5.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2fe41ae7472685128c96da9a567e5309a1ab4de1073ac0bdfd67bb33e9935782
|
|
| MD5 |
2cab5c21cd74f034120a6dcd9bacd9e6
|
|
| BLAKE2b-256 |
bc0e051ebb1caf1f0571f838c5c92b1afd87f09ca77a26f771eabe045146c83e
|
File details
Details for the file mandown-1.12.2-py3-none-any.whl.
File metadata
- Download URL: mandown-1.12.2-py3-none-any.whl
- Upload date:
- Size: 52.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.1.3 CPython/3.13.5 Darwin/24.5.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ceca7bc61a71f232a838faa4cde25d79337f6b8e105ef50baced403d0aaff249
|
|
| MD5 |
d40f9165c7981c970a1c5fe8c6009ca6
|
|
| BLAKE2b-256 |
4db03faf2d8ab9c9a77de288402354553a0d5378fcb99398d4821890fd916a4f
|
