Skip to content

Latest commit

 

History

History
43 lines (27 loc) · 1.71 KB

README.md

File metadata and controls

43 lines (27 loc) · 1.71 KB

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 ✔️ ✔️
EPUB ✔️ ✔️
PDF ✔️ ✔️
MOBI ✔️

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