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
• Search manga metadata through AniList
  • Lightweight cards, paginated results, and on-demand details
  • Resolver-ready MangaDex, WEBTOON, and Naver external links
• 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>

Search AniList when you do not already know a supported series URL:

mandown search "Solo Leveling"
mandown search "Solo Leveling" --details --external-links

The CLI returns 10 results by default and accepts --page and --limit. Mandown caps the CLI limit at 25 as a performance choice; the Python client can use AniList's full Page.perPage range through 50.

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: --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 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 git+https://github.com/Berkwe/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/Berkwe/mandown
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://comic.naver.com
• https://series.naver.com (when the comic has a matching Naver Webtoon edition)
• https://mangadex.org
• https://readcomiconline.li
• https://www.kuaikanmanhua.com

Basic library usage

See the Python API guide for the main functions, arguments, return values, and examples. The topic guides contain more information about downloading, processing, and conversion.

Search AniList, load details only for the selected result, and pass a supported external URL to Mandown's existing resolver:

import asyncio
import mandown


async def find_download_url():
    async with mandown.AniListClient() as client:
        results = await client.search_manga("Solo Leveling")
        details = await client.get_manga(results.items[0].id)
        sources = client.extract_supported_sources(details.external_links)
        return sources[0].url if sources else None


download_url = asyncio.run(find_download_url())
if download_url:
    mandown.download(download_url, "./downloads")

AniList is the only active title-search source. Direct URL querying and downloading for MangaDex, WEBTOON, Naver Webtoon, and the other supported sites continues to work normally.

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")