https://github.com/potatoeggy/mandown
Comic/manga/webtoon downloader and CBZ/EPUB/MOBI/PDF converter
https://github.com/potatoeggy/mandown
cbz comics converter downloader ebook epub ereader kobo manga pdf python python3 webtoon webtoons
Last synced: 7 months ago
JSON representation
Comic/manga/webtoon downloader and CBZ/EPUB/MOBI/PDF converter
- Host: GitHub
- URL: https://github.com/potatoeggy/mandown
- Owner: potatoeggy
- License: agpl-3.0
- Created: 2022-01-03T22:27:32.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-19T03:13:15.000Z (over 1 year ago)
- Last Synced: 2024-05-19T04:22:58.345Z (over 1 year ago)
- Topics: cbz, comics, converter, downloader, ebook, epub, ereader, kobo, manga, pdf, python, python3, webtoon, webtoons
- Language: Python
- Homepage:
- Size: 438 KB
- Stars: 41
- Watchers: 5
- Forks: 7
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# mandown
[](http://mypy-lang.org/)
[](https://pypi.org/project/mandown)
[](https://aur.archlinux.org/packages/mandown-git)
[](https://github.com/potatoeggy/mandown/releases/latest)
[](/LICENSE)
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](https://github.com/ciromattia/kcc).
## Features
- Download comics from [supported sites](#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](#basic-library-usage)
## Usage
Run `mandown --help` or see the [docs](/docs/) for more information and examples.
```
mandown get
```
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 --convert epub --process rotate_double_pages
```
To download only a certain range of chapters, append the `--start` and/or `--end` options.
> **Note:** `--start` and `--end` are _inclusive_, i.e., using `--start 2 --end 3` will download chapters 2 and 3.
To convert an existing folder or comic file without downloading anything (like a stripped-down version of ), use the `convert` command.
```
mandown convert
```
To process an existing folder without downloading anything, use the `process` command.
```
mandown process
```
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](https://aur.archlinux.org/packages/mandown-git):
```
git clone https://aur.archlinux.org/mandown-git.git
makepkg -si
```
Or, to build from source:
Mandown uses [poetry](https://github.com/python-poetry/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://github.com/potatoeggy/mandown/issues/new?title=Source%20request:).
-
-
-
- https://\*.thecomicseries.com
-
-
-
-
-
-
-
-
## Basic library usage
See the [docs](/docs/) for more information and examples.
To just download the images:
```python
import mandown
mandown.download("https://comic-site.com/the-best-comic")
```
To download and convert to EPUB:
```python
import mandown
comic = mandown.query("https://comic-site.com/the-best-comic")
mandown.download(comic)
mandown.convert(comic, title=comic.metadata.title, to="epub")
```