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
Metadata
1 maintainer
Release files for mandown 1.12.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mandown-1.12.2.tar.gz | 41.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mandown-1.12.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 93.7 kB
Release files / mandown-1.12.2.tar.gz
| Download URL | mandown-1.12.2.tar.gz |
|---|---|
| Size | 41.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2fe41ae7472685128c96da9a567e5309a1ab4de1073ac0bdfd67bb33e9935782
|
|
BLAKE2b-256 checksum How to use checksums |
bc0e051ebb1caf1f0571f838c5c92b1afd87f09ca77a26f771eabe045146c83e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.13.5 Darwin/24.5.0
|
Release files / mandown-1.12.2-py3-none-any.whl
| Download URL | mandown-1.12.2-py3-none-any.whl |
|---|---|
| Size | 52.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ceca7bc61a71f232a838faa4cde25d79337f6b8e105ef50baced403d0aaff249
|
|
BLAKE2b-256 checksum How to use checksums |
4db03faf2d8ab9c9a77de288402354553a0d5378fcb99398d4821890fd916a4f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.13.5 Darwin/24.5.0
|
