Kindle Comic Converter is a Python app to convert comic/manga files or folders to EPUB, Panel View MOBI or E-Ink optimized CBZ. It was initially developed for Kindle but since version 4.6 it outputs valid EPUB 3.0 so despite its name, KCC is actually a comic/manga to EPUB converter that every e-reader owner can happily use. It can also optionally optimize images by applying a number of transformations.
A word of warning
KCC is not Amazon's Kindle Comic Creator nor is in any way endorsed by Amazon. Amazon's tool is for comic publishers and involves a lot of manual effort, while KCC is for comic/manga readers. KC2 in no way is a replacement for KCC so you can be quite confident we are going to carry on developing our little monster ;-)
Issues / new features / donations
If you have general questions about usage, feedback etc. please post it here. If you have some technical problems using KCC please file an issue here. If you can fix an open issue, fork & make a pull request.
If you find KCC valuable you can consider donating to the authors:
You can find the latest released binary at the following links:
KCC is also available on PyPI.
pip install --user KindleComicConverter
Following software is required to run Linux version of KCC and/or bare sources:
On Debian based distributions these two commands should install all needed dependencies:
sudo apt-get install python3 python3-dev python3-pip libpng-dev libjpeg-dev p7zip-full pip3 install --user --upgrade pillow python-slugify psutil pyqt5 raven
- KindleGen v2.9+ in a directory reachable by your PATH or in KCC directory (For MOBI generation)
- 7z (For CBZ/ZIP, CBR/RAR, 7z/CB7 support)
KCC can understand and convert, at the moment, the following input types:
- Folders containing: PNG, JPG, GIF or WebP files
- CBZ, ZIP (With
- CBR, RAR (With
- CB7, 7Z (With
- PDF (Only extracting JPG images)
Should be pretty self-explanatory. All options have detailed information in tooltips. After completed conversion, you should find ready file alongside the original input file (same directory).
Please check our wiki for more details.
CLI version of KCC is intended for power users. It allows using options that might not be compatible and decrease the quality of output.
Usage: kcc-c2e [options] comic_file|comic_folder Options: MAIN: -p PROFILE, --profile=PROFILE Device profile (Available options: K1, K2, K34, K578, KDX, KPW, KV, KO, KoMT, KoG, KoGHD, KoA, KoAHD, KoAH2O, KoAO, KoF) [Default=KV] -m, --manga-style Manga style (right-to-left reading and splitting) -q, --hq Try to increase the quality of magnification -2, --two-panel Display two not four panels in Panel View mode -w, --webtoon Webtoon processing mode OUTPUT SETTINGS: -o OUTPUT, --output=OUTPUT Output generated file to specified directory or file -t TITLE, --title=TITLE Comic title [Default=filename or directory name] -f FORMAT, --format=FORMAT Output format (Available options: Auto, MOBI, EPUB, CBZ, KFX) [Default=Auto] -b BATCHSPLIT, --batchsplit=BATCHSPLIT Split output into multiple files. 0: Don't split 1: Automatic mode 2: Consider every subdirectory as separate volume [Default=0] PROCESSING: -u, --upscale Resize images smaller than device's resolution -s, --stretch Stretch images to device's resolution -r SPLITTER, --splitter=SPLITTER Double page parsing mode. 0: Split 1: Rotate 2: Both [Default=0] -g GAMMA, --gamma=GAMMA Apply gamma correction to linearize the image [Default=Auto] -c CROPPING, --cropping=CROPPING Set cropping mode. 0: Disabled 1: Margins 2: Margins + page numbers [Default=2] --cp=CROPPINGP, --croppingpower=CROPPINGP Set cropping power [Default=1.0] --blackborders Disable autodetection and force black borders --whiteborders Disable autodetection and force white borders --forcecolor Don't convert images to grayscale --forcepng Create PNG files instead JPEG CUSTOM PROFILE: --customwidth=CUSTOMWIDTH Replace screen width provided by device profile --customheight=CUSTOMHEIGHT Replace screen height provided by device profile OTHER: -h, --help Show this help message and exit
Usage: kcc-c2p [options] comic_folder Options: MANDATORY: -y HEIGHT, --height=HEIGHT Height of the target device screen -i, --in-place Overwrite source directory -m, --merge Combine every directory into a single image before splitting OTHER: -d, --debug Create debug file for every split image -h, --help Show this help message and exit
This script born as a cross-platform alternative to
KindleComicParser by Dc5e (published here).
The app relies and includes the following scripts:
DualMetaFixscript by K. Hendricks. Released with GPL-3 License.
image.pyclass from Alex Yatskov's Mangle with subsequent proDOOMman's and Birua's patches.
- Icon is by Nikolay Verin (http://ncrow.deviantart.com/) and released under CC BY-NC-SA 3.0 License.
SAMPLE FILES CREATED BY KCC
- Kindle Oasis 2 / 3
- Kindle Paperwhite 3 / 4 / Voyage / Oasis
- Kindle Paperwhite 1 / 2
- Kobo Aura
- Kobo Aura HD
- Kobo Aura H2O
- Kobo Aura ONE
- Kobo Forma
KCC is initiating internet connections in two cases:
- During startup - Version check.
- When error occurs - Automatic reporting on Windows and macOS.
Please check wiki page.
Copyright (c) 2012-2019 Ciro Mattia Gonano and Paweł Jastrzębski. KCC is released under ISC LICENSE; see LICENSE.txt for further details.