Skip to main content

Command line application and library to download and convert comics from various sources

Project description

mandown

Code style: black Checked with mypy Download from PyPI Download from the AUR Latest release License

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.

Installation

Install the package from PyPI:

pip3 install mandown

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 download <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 download <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 os
import mandown
from mandown.converter import Converter

comic = mandown.query(url_to_comic)
print(comic.metadata, comic.chapters)
for c in comic.chapters:
    mandown.download_chapter(c, dest_folder=os.getcwd(), maxthreads=4)

folder_path = os.getcwd()
mandown.process(folder_path, [ProcessOps.TRIM_BORDERS, ProcessOps.ROTATE_DOUBLE_PAGES])

converter = Converter(folder_path, metadata=comic.metadata)
converter.to_epub()

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mandown-0.8.1a1.dev1.tar.gz (21.2 kB view details)

Uploaded Source

Built Distribution

mandown-0.8.1a1.dev1-py3-none-any.whl (27.1 kB view details)

Uploaded Python 3

File details

Details for the file mandown-0.8.1a1.dev1.tar.gz.

File metadata

  • Download URL: mandown-0.8.1a1.dev1.tar.gz
  • Upload date:
  • Size: 21.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.10.2 Linux/5.16.15-zen1-1-zen

File hashes

Hashes for mandown-0.8.1a1.dev1.tar.gz
Algorithm Hash digest
SHA256 c9cf3646cfa0f9a3228eb939dbdafafc34141c45831385cfcaf41c15f325ef11
MD5 a23022dece925be649677348ef657f75
BLAKE2b-256 5bd0ee901c48fd0cd8ac4379eeb57fc2d885dfbe3e1f3d506ebf1b52ab759c2a

See more details on using hashes here.

File details

Details for the file mandown-0.8.1a1.dev1-py3-none-any.whl.

File metadata

  • Download URL: mandown-0.8.1a1.dev1-py3-none-any.whl
  • Upload date:
  • Size: 27.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.10.2 Linux/5.16.15-zen1-1-zen

File hashes

Hashes for mandown-0.8.1a1.dev1-py3-none-any.whl
Algorithm Hash digest
SHA256 2263ee48df84a4b450c66823bb67e9779c0ceb03ff7f3cb81a49e7ffcbf282b7
MD5 5d3103b5e927233284e86ff53bb54c70
BLAKE2b-256 65867dae94c7938e88c42dd27342166aa23f4095d4d6e90c4cef6cd01f58838b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page