Skip to main content

A simple comic conversion library between CBZ/EPUB/MOBI/PDF

Project description

Comicon

Comicon is a lightweight comic converter library between CBZ, PDF, EPUB, and MOBI that preserves metadata. Once Comicon has converted a comic, it is guaranteed that the reverse conversion will restore the original comic with all of its original metadata.

Usage

For a command line interface, please see Mandown.

import comicon

comicon.convert("comic.cbz", "comic.epub")

Installation

Amazon's Kindlegen is required if you want to convert to MOBI. See here for more information.

Comicon is available from PyPI:

pip install comicon

Supported conversions

Format Convert from? Convert to?
CBZ :heavy_check_mark: :heavy_check_mark:
EPUB :heavy_check_mark: :heavy_check_mark:
PDF :heavy_check_mark: :heavy_check_mark:
MOBI :x: :heavy_check_mark:

Format discrepancies

  • Only EPUB supports a table of contents. CBZ and PDF will encode the table of contents so that it is restored upon converting to EPUB.
  • PDF does not support importing genre data due to a lack of library support. This may be worked around in the future.

Notes

Under the hood, Comicon converts each format into the Comicon Intermediate Representation (CIR) — more or less a strictly structured folder, which allows for many guarantees to be made for each input and output plugin. See comicon.cirtools for more information.

For new input and output formats to be added, they should be added in comicon.inputs or comicon.outputs respectively as a new module and in the __init__.py file(s).

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

comicon-1.2.0.tar.gz (25.2 kB view hashes)

Uploaded Source

Built Distribution

comicon-1.2.0-py3-none-any.whl (30.5 kB view hashes)

Uploaded Python 3

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