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: |
: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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.