ciromattia/kcc

[Title: Ubunchu! | Author: Hiroshi Seo | Publisher: ASCII MEDIA WORKS Inc.]

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, PDF, and folders of images.

The absolute highest quality source files are DRM-free PDFs from Humble Bundle/Fanatical. The PDFs are often x12000 resolution or better, while even the 10" Kindle Scribe is only x2480.

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. doesn't add extra margins like other software. KCC enables true fullscreen top to bottom.

[Title: Ya Boy Kongming! | Story: Yuto Yotsuba | Art: Ryo Ogawa | Publisher: Kodansha | Source: Humble Bundle]

3. fixes black levels to avoid gray/faded blacks found in many Kindle Store manga. (The original source was gray, KCC processing made it black.)

[Title: Fire Force | Author: Atsushi Ohkubo | Publisher: Kodansha | Source: Humble Bundle]

4. fixes the rainbow effect on Kaleido 3 color eink without blur using a 2D Discrete Fourier Transform:

5. can semi-automatically detect 2-page spreads from pre-split single pages:

You can view combined spreads either rotated or not:

You can view the split halves either before or after combined spreads:

Demo

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

There are a lot of options, but most people only care about the ones checked above.

Hover over each option to see details in a tooltip.

NOTE: some checkboxes can have a half-check marks.

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

Here's a quick video demo of how the process works (using expert mode):

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

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

WARNING: Kindle Scribe 2025 MOBI support is limited, converted books may have blank pages. Use PDF instead.

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

Kindle Jailbreak for KOreader

Jailbreaking to use KOreader is optional. MOBI manga converted by KCC can be opened in Kindle’s native reader just fine

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

1. compatibility with image formats better suited for manga like dithered 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.
3. You can dither by partially checking the JPG/PNG box and can crop in KCC instead of KOreader. This may increase page turn speed and battery.

Common KOreader manga mistakes: https://youtu.be/gaakIh9p8tw?si=X7OgPJlAvL9XGbLR

Set per folder setting defaults: https://youtu.be/O9p6HVWIQ6s?si=Jtx607erCBA_auWM

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

• Free code signing on Windows provided by SignPath.io, certificate by SignPath Foundation

DOWNLOADS

• https://github.com/ciromattia/kcc/releases

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 10.14+)

There are also various builds for niche platforms like Windows 7, Windows 11 ARM,

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

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?
  • May happen when using PNG with Kindle Scribe or any format with a Kindle Colorsoft. Solve by using JPG with Kindle Scribe or buying a Kobo Colour. Happens more often when turning pages really fast. You can try PDF output. Going back a few pages and exiting and re-entering book should fix it temporarily.
• What output format should I use?
  • MOBI for modern Kindles. CBZ for KF7 Kindles like the Kindle 1/2/3/DX. CBZ for Koreader. KEPUB for Kobo (Kobo profile + EPUB = KEPUB). PDF for ReMarkable or Kindle Scribe 2025.
• Where is KEPUB option?
  • Choosing a Kobo profile and EPUB output will output KEPUB.
• KEPUB crashes on Kobo?
  • Remove any special characters like ! from the filepath, including any intermediate folders.
• 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
• No page turn animation on Kindle MOBI?
  • Use legacy panel view option. Or enable page turn animation in a normal book and then come back to the mobi.
• 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

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:

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

Profiles:

        'K1': ("Kindle 1", (600, 670), Palette4, 1.0),
        'K2': ("Kindle 2", (600, 670), Palette15, 1.0),
        'K11': ("Kindle 11/2026", (1072, 1448), Palette16, 1.0),
        'K34': ("Kindle Keyboard/Touch", (600, 800), Palette16, 1.0),
        'K57': ("Kindle 5/7", (600, 800), Palette16, 1.0),
        'K810': ("Kindle 8/10", (600, 800), Palette16, 1.0),
        'KDX': ("Kindle DX/DXG", (824, 1000), Palette16, 1.0),
        'KPW': ("Kindle Paperwhite 1/2", (758, 1024), Palette16, 1.0),
        'KV': ("Kindle Voyage", (1072, 1448), Palette16, 1.0),
        'KPW34': ("Kindle Paperwhite 3/4", (1072, 1448), Palette16, 1.0),
        'KPW5': ("Kindle Paperwhite 5/Signature Edition", (1236, 1648), Palette16, 1.0),
        'KPW6': ("Kindle Paperwhite 6/2026", (1272, 1696), Palette16, 1.0),
        'KO': ("Kindle Oasis 2/3", (1264, 1680), Palette16, 1.0),
        'KCS': ("Kindle Colorsoft", (1272, 1696), Palette16, 1.0),
        'KS1860': ("Kindle 1860", (1860, 1920), Palette16, 1.0),
        'KS1920': ("Kindle 1920", (1920, 1920), Palette16, 1.0),
        'KS1240': ("Kindle 1240", (1240, 1860), Palette16, 1.0),
        'KS1324': ("Kindle 1324", (1324, 1986), Palette16, 1.0),
        'KS': ("Kindle Scribe 1/2", (1860, 2480), Palette16, 1.0),
        'KS3': ("Kindle Scribe 3", (1986, 2648), Palette16, 1.0),
        'KSCS': ("Kindle Scribe Colorsoft", (1986, 2648), Palette16, 1.0),
        'KoMT': ("Kobo Mini/Touch", (600, 800), Palette16, 1.0),
        'KoG': ("Kobo Glo", (768, 1024), Palette16, 1.0),
        'KoGHD': ("Kobo Glo HD", (1072, 1448), Palette16, 1.0),
        'KoA': ("Kobo Aura", (758, 1024), Palette16, 1.0),
        'KoAHD': ("Kobo Aura HD", (1080, 1440), Palette16, 1.0),
        'KoAH2O': ("Kobo Aura H2O", (1080, 1430), Palette16, 1.0),
        'KoAO': ("Kobo Aura ONE", (1404, 1872), Palette16, 1.0),
        'KoN': ("Kobo Nia", (758, 1024), Palette16, 1.0),
        'KoC': ("Kobo Clara HD/Kobo Clara 2E/Kobo Clara BW", (1072, 1448), Palette16, 1.0),
        'KoCC': ("Kobo Clara Colour", (1072, 1448), Palette16, 1.0),
        'KoL': ("Kobo Libra H2O/Kobo Libra 2", (1264, 1680), Palette16, 1.0),
        'KoLC': ("Kobo Libra Colour", (1264, 1680), Palette16, 1.0),
        'KoF': ("Kobo Forma", (1440, 1920), Palette16, 1.0),
        'KoS': ("Kobo Sage", (1440, 1920), Palette16, 1.0),
        'KoE': ("Kobo Elipsa", (1404, 1872), Palette16, 1.0),
        'Rmk1': ("reMarkable 1", (1404, 1872), Palette16, 1.0),
        'Rmk2': ("reMarkable 2", (1404, 1872), Palette16, 1.0),
        'RmkPP': ("reMarkable Paper Pro", (1620, 2160), Palette16, 1.0),
        'RmkPPMove': ("reMarkable Paper Pro Move", (954, 1696), Palette16, 1.0),
        'OTHER': ("Other", (0, 0), Palette16, 1.0),

Standalone kcc-c2e.py usage:

usage: kcc-c2e [options] [input]

MANDATORY:
  input                 Full path to comic folder or file(s) to be processed.

MAIN:
  -p PROFILE, --profile PROFILE
                        Device profile (Available options: K1, K2, KDX, K34, K57, KPW, KV, KPW34, K810, KO, K11, KPW5, KPW6, KS1860, KS1920,
                        KS1240, KS1324, KS, KCS, KS3, KSCS, KoMT, KoG, KoGHD, KoA, KoAHD, KoAH2O, KoAO, KoN, KoC, KoCC, KoL, KoLC, KoF, KoS, KoE,
                        Rmk1, Rmk2, RmkPP, RmkPPMove, OTHER, 1072x1448, 1264x1680, 1404x1872, 1536x2048, 1650x2200, 1860x2480, 2400x3200)
                        [Default=KV]
  -m, --manga-style     Manga style (right-to-left reading and splitting)
  --lightnovel          Only resize images and preserve original file structure.
  --ebok                Force EBOK tag instead of PDOC for MOBI
  --invertdirection     Invert page turn direction
  -q, --hq              Try to increase the quality of magnification
  -2, --two-panel       Display two not four panels in Panel View mode
  --vertical4panel      Show side panels first in virtual panel view
  --legacypanelview     Use legacy panel view method from KCC 6
  -w, --webtoon         Webtoon processing mode
  --ts TARGETSIZE, --targetsize TARGETSIZE
                        the maximal size of output file in MB. [Default=100MB for webtoon and 400MB for others]

PROCESSING:
  -n, --noprocessing    Do not modify image and ignore any profile or processing option
  --legacyextract       Use legacy PDF/EPUB image extraction method from earlier KCC versions.
  --pdfwidth            Render vector PDFs based on device width instead of height.
  -u, --upscale         Resize images smaller than device's resolution
  -s, --stretch         Stretch images to device's resolution
  --wallpaper           Crop images to to fill screen
  -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]
  --autolevel           Set most common dark pixel value to be black point for leveling.
  --noautocontrast      Disable autocontrast
  --colorautocontrast   Force autocontrast for all pages. Skipped when near blacks and whites don't exist
  -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]
  --preservemargin      After calculating crop, "back up" a specified percentage amount [Default=0]
  --cm CROPPINGM, --croppingminimum CROPPINGM
                        Set cropping minimum area ratio [Default=0.0]
  --ipc INTERPANELCROP, --interpanelcrop INTERPANELCROP
                        Crop empty sections. 0: Disabled 1: Horizontally 2: Both [Default=0]
  --blackborders        Disable autodetection and force black borders
  --whiteborders        Disable autodetection and force white borders
  --smartcovercrop      Attempt to crop main cover from wide image
  --coverfill           Center-crop only the cover to fill target device screen
  --forcecolor          Don't convert images to grayscale
  --forcepng            Create PNG files instead JPEG for black and white images
  --webp                Replace JPG with lossy WEBP and PNG with lossless WEBP
  --force-png-rgb       Force color images to be saved as PNG
  --pnglegacy           Use a more compatible 8 bit PNG instead of 4 bit.
  --noquantize          Don't quantize PNG images to 16 colors
  --mozjpeg             Create JPEG files using mozJpeg
  --jpeg-quality        The JPEG quality, on a scale from 0 (worst) to 95 (best). Default 85 for most devices.
  --maximizestrips      Turn 1x4 strips to 2x2 strips
  -d, --delete          Delete source file(s) or a directory. It's not recoverable.
  --tempdir             Create temporary files directory on source file drive.

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]
  --metadatatitle       Write title using ComicInfo.xml or other embedded metadata. 0: Don't use Title from metadata 1: Combine Title with default schema 2: Use Title only [Default=0]
  --keepcomicinfo       Keep any original ComicInfo.xml files [Default=0]
  -a AUTHOR, --author AUTHOR
                        Author name [Default=KCC]
  --language            EPUB language [Default=en-US]
  -f FORMAT, --format FORMAT
                        Output format (Available options: Auto, MOBI, EPUB, CBZ, PDF, KFX, MOBI+EPUB) [Default=Auto]
  --nokepub             If format is EPUB, output file with '.epub' extension rather than '.kepub.epub'
  -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]
  --spreadshift         Shift first page to opposite side in landscape for two page spread alignment
  --onepagelandscape    Show a single centered page in landscape
  --norotate            Do not rotate double page spreads in spread splitter option.
  --rotateright         Rotate double page spreads in opposite direction.
  --rotatefirst         Put rotated spread first in spread splitter option.
  --filefusion          Combines all input files into a single file.
  --eraserainbow       Erase rainbow effect on color eink screen by attenuating interfering frequencies

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

Standalone kcc-c2p.py usage:

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.

When adding or changing translatable strings (self.tr(...)), run the gen_translation_files scripts to regenerate the translation sources and recompile them; see TRANSLATION.md for the full workflow.

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

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:

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:

venv\Scripts\activate.bat
python kcc.py

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

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:

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:

source venv/bin/activate
python kcc.py

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

python setup.py build_binary

CREDITS

KCC is made by

• Ciro Mattia Gonano
• Paweł Jastrzębski
• Darodi
• Alex Xu

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

The app relies and includes the following scripts:

• DualMetaFix script by K. Hendricks. Released with GPL-3 License.
• image.py class 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

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

Older links (dead):

• Kindle Oasis 2 / 3
• Kindle Paperwhite 3 / 4 / Voyage / Oasis
• Kindle Paperwhite 1 / 2
• Kindle
• Kobo Aura
• Kobo Aura HD
• Kobo Aura H2O
• Kobo Aura ONE
• Kobo Forma

PRIVACY

KCC is initiating internet connections in two cases:

• During startup - Version check and announcement check.

KNOWN ISSUES

Please check wiki page.

COPYRIGHT

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

Awin