kcc Documentation

KCC (a.k.a. Kindle Comic Converter) is a comic and manga converter for ebook readers.

5,484 stars Python Python 1 file Β· ~3,791 tokens #azw3#cbz#comics#eink#epub#kindle#kobo#koreader
RAW Doc

Docker & Self-Hosted Deployment Verified OCI

Deploy kcc on any server, homelab, or cloud container platform.

1-Click Terminal Command
bash (docker run) 
docker run -d --name kcc --restart always ciromattia/kcc:latest

Most manga conversion methods for ereaders add margins. But KCC enables true fullscreen from top to bottom.

(feat. Ya Boy Kongming! Humble Bundle PDF source.)

KCC



Kindle Comic Converter optimizes black & white (or color) comics and manga for E-ink ereaders
like Kindle, Kobo, ReMarkable, and more.
Pages display in fullscreen without margins,
with proper fixed layout support.
KCC runs on Windows, macOS, and Linux.

Supported input formats include JPG/PNG image files in folders, archives like CBZ/EPUB, or PDF.

Supported output formats include MOBI/AZW3, EPUB, KEPUB, CBZ, and PDF.

The absolute highest quality source files are DRM-free PDFs from Humble Bundle/Fanatical.
The PDFs are often x12000 resolution or better, basically print quality.

KCC's main goal is maximum image quality at significantly smaller file size. For example, KCC

  1. can compress a 600 MB manga volume from Humble Bundle to 100 MB.
    This is mostly accomplished by downscaling to the native resolution of your specific device.
    This can also improve battery life, page turn speed, and general performance
    on underpowered ereaders with small memory and storage capacities.

  2. fixes black levels to avoid gray/faded blacks found in many Kindle Store manga

(feat. Fire Force)

  1. fixes the rainbow effect on Kaleido 3 color eink without blur:

Just drop your input files into the KCC window, hit convert, and USB drop the output files onto your device's documents folder!

https://github.com/user-attachments/assets/da73d625-e082-482d-91a4-ae4765e96fd7

Then all your usb loaded comic files will show up next to all your normal books in your ereader library!

The final result looks incredible on my 10" Kindle Scribe: https://www.youtube.com/watch?v=2CIHW2N9Enc

WARNING: Kindle Scribe 2025 MOBI support may have blank pages. Use PDF instead.

The GUI looks like this, built in Qt6. There are a lot of options, but most people only care about the ones checked below:

Simply drag and drop your files/folders into the KCC window,
adjust your settings (hover over each option to see details in a tooltip),
and hit convert to create ereader optimized files.
Then just drag and drop the generated output files onto your device's documents folder via USB.
If you are on macOS and use a 2022+ Kindle, you may need to use Amazon USB File Manager for Mac or OpenMTP.

YouTube tutorial (please subscribe): https://www.youtube.com/watch?v=QQ6zJcMF2Iw

Installation tutorial: https://www.youtube.com/watch?v=IR2Fhcm9658

Semi automatically merge pre-split 2-page spreads tutorial: https://www.youtube.com/watch?v=kfIX67f7Aqk

Kindle Jailbreak for KOreader

Jailbreaking to use KOreader is optional. KCC works just fine with the native mobi manga viewer.

But if you jailbreak your Kindle, you'll unlock additional features like:

  1. compatibility with image formats better suited for manga like 4-bit PNG and WEBP. This enables better quality at half the file size compared to JPG which must be 8-bit.
    This is visually lossless since eink screens are 4-bit.
  2. no dependency on kindlegen, which can mean twice as fast conversions since you can convert to CBZ directly.

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:

  • Ciro Mattia Gonano (founder, active 2012-2014):

  • PaweΕ‚ JastrzΔ™bski (active 2013-2019):


  • Alex Xu (active 2023-Present)

Commissions

This section is subject to change:

Email (for commisions and inquiries): kindle.comic.converter gmail

Sponsors

DOWNLOADS

Click on Assets of the latest release.

You probably want either

  • KCC_*.*.*.exe (Windows)
  • kcc_macos_arm_*.*.*.dmg (recent Mac with Apple Silicon M1 chip or later)
  • kcc_macos_i386_*.*.*.dmg (older Mac with Intel chip macOS 14+)

There are also legacy macOS 10.14+ and Windows 7 experimental versions available.

The c2e and c2p versions are command line tools for power users.

On macOS, if you get a can't be opened error, follow: https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unknown-developer-mh40616/mac

For flatpak, Docker, and AppImage versions, refer to the wiki: https://github.com/ciromattia/kcc/wiki/Installation

FAQ

  • Should I use Calibre?
    • No. Calibre doesn't properly support fixed layout EPUB/MOBI, so modifying KCC output (even just metadata!) in Calibre can break the formatting.
      Additionally, it will break page numbers.
      Viewing KCC output in Calibre will also not work properly.
      Direct USB dropping is reccomended.
  • Blank pages?
  • What output format should I use?
    • MOBI for Kindles. CBZ for Kindle DX. CBZ for Koreader. KEPUB for Kobo. PDF for ReMarkable or Kindle Scribe 2025.
  • Where is KEPUB option?
    • Choosing a Kobo profile and EPUB output will output KEPUB.
  • All options have additional information in tooltips if you hover over the option.
  • To get the converted book onto your Kindle/Kobo, just drag and drop the mobi/kepub into the documents folder on your Kindle/Kobo via USB
  • Kindle panel view not working?
    • Virtual panel view is enabled in Aa menu on your Kindle, not in KCC as of 7.4
  • Right to left mode not working?
    • RTL mode only affects splitting order for CBZ output. Your cbz reader itself sets the page turn direction.
  • Colors inverted?
    • Disable Kindle dark mode
  • Cannot connect Kindle Scribe or 2024+ Kindle to macOS
    • Use official MTP Amazon USB File Transfer app
      (no login required). Works much better than previously recommended Android File Transfer. Cannot run simutaneously with other transfer apps.
  • How to make AZW3 instead of MOBI?
    • The .mobi file generated by KCC is a dual filetype, it's both MOBI and AZW3. The file extension is .mobi for compatibility reasons.
  • Huge margins / slow page turns?
    • You likely modified the file during transfer using a 3rd party app. Try simply dragging and dropping the final mobi/kepub file into the Kindle documents folder via USB.

PREREQUISITES

You'll need to install various tools to access important but optional features. Close and re-open KCC to get KCC to detect them.

KindleGen

(This is not needed for Koreader users on jailbroken Kindle. Just set output to CBZ instead.)

On Windows and macOS, install Kindle Previewer and kindlegen will be autodetected from it.

If you have issues detecting it, get stuck on the MOBI conversion step, or use Linux AppImage or Flatpak, refer to the wiki: https://github.com/ciromattia/kcc/wiki/Installation#kindlegen

7-Zip

This is optional but will make conversions much faster.

This is required for certain files and advanced features.

KCC will ask you to install if needed.

Refer to the wiki to install: https://github.com/ciromattia/kcc/wiki/Installation#7-zip

INPUT FORMATS

KCC can understand and convert, at the moment, the following input types:

  • Folders containing: PNG, JPG, GIF or WebP files
  • CBZ, ZIP (With 7z executable)
  • CBR, RAR (With 7z executable)
  • CB7, 7Z (With 7z executable)
  • PDF (Only extracting JPG images)

USAGE

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.
CLI version has reduced dependencies, on Debian based distributions this commands should install all needed dependencies:

text
sudo apt-get install python3 p7zip-full python3-pil python3-psutil python3-slugify

Profiles:

text
/* Detailed source-code truncated for AI context efficiency. */

Standalone `kcc-c2e.py` usage:

text
/* Detailed source-code truncated for AI context efficiency. */

Standalone `kcc-c2p.py` usage:

text
usage: kcc-c2p [options] [input]

MANDATORY:
  input                 Full path to comic folder(s) to be processed. Separate multiple inputs with spaces.

MAIN:
  -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

INSTALL FROM SOURCE

This section is for developers who want to contribute to KCC or power users who want to run the latest code without waiting for an official release.

Easiest to use GitHub Desktop to clone your fork of the KCC repo. From GitHub Desktop, click on Repository in the toolbar, then Command Prompt (Windows)/Terminal (Mac) to open a window in the KCC repo.

Depending on your system Python may be called either python or python3. We use virtual environments (venv) to manage dependencies.

If you want to edit the code, a good code editor is VS Code.

If you want to edit the .ui files, use pyside6-designer which is included in the pip install pyside6.
If new objects have been added, verify that correct tab order has been applied by using Tab Order Editing Mode.
Then use the gen_ui_files scripts to autogenerate the python UI.

An example PR adding a new checkbox is here: https://github.com/ciromattia/kcc/pull/785

video of adding a new checkbox: https://youtu.be/g3I8DU74C7g

Do not use git merge to merge master from upstream,
use the "Sync fork" button on your fork on GitHub in your branch
to avoid weird looking merges in pull requests.

When making changes, be aware of how your change might affect file splitting/chunking
or chapter alignment.

Windows install from source

One time setup and running for the first time:

text
python -m venv venv
venv\Scripts\activate.bat
pip install --upgrade pip
pip install -r requirements.txt
python kcc.py

Every time you close Command Prompt, you will need to re-activate the virtual environment and re-run:

text
venv\Scripts\activate.bat
python kcc.py

You can build a .exe of KCC like the downloads we offer with

text
python setup.py build_binary

macOS install from source

If the system installed Python gives you issues, please install the latest Python from either brew or the official website.

One time setup and running for the first time:

text
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
python kcc.py

Every time you close Terminal, you will need to reactivate the virtual environment and re-run:

text
source venv/bin/activate
python kcc.py

You can build a .app of KCC like the downloads we offer with

text
python setup.py build_binary

CREDITS

KCC is made by

This script born as a cross-platform alternative to KindleComicParser by Dc5e (published here).

The app relies and includes the following scripts:

SAMPLE FILES CREATED BY KCC

https://www.mediafire.com/folder/ixh40veo6hrc5/kcc_samples

Older links (dead):

PRIVACY

KCC is initiating internet connections in two cases:

  • During startup - Version check and announcement check.

KNOWN ISSUES

Please check wiki page.

Copyright (c) 2012-2025 Ciro Mattia Gonano, PaweΕ‚ JastrzΔ™bski, Darodi and Alex Xu.
KCC is released under ISC LICENSE; see LICENSE.txt for further details.

Verification

Impact-Site-Verification: ffe48fc7-4f0c-40fd-bd2e-59f4d7205180

Explore Related Technologies & Topics

View All 9,111+ Repositories β†’

Discover similar high-velocity repositories, agent skills, and OpenAPI specifications across the ecosystem.

#azw3 Browse azw3 catalog β†’ #cbz Browse cbz catalog β†’ #comics Browse comics catalog β†’ #eink Browse eink catalog β†’ #epub Browse epub catalog β†’ #kindle Browse kindle catalog β†’ ⚑ MCP Servers Model Context Protocol β†’ 🧠 Agent Skills Prompt & rule files β†’ πŸ”Œ OpenAPI Specs REST & Swagger schemas β†’