MCPcopy
hub / github.com/ciromattia/kcc

github.com/ciromattia/kcc @v10.3.0 sqlite

repository ↗ · DeepWiki ↗ · release v10.3.0 ↗
244 symbols 873 edges 23 files 10 documented · 4%
README

Header Image

KCC

GitHub release GitHub Workflow Status Github All Releases

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. Supported input formats include JPG/PNG image files in folders, archives like CBZ, or PDFs. Supported output formats include MOBI/AZW3, EPUB, KEPUB, CBZ, and PDF. KCC runs on Windows, macOS, and Linux.

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

WARNING: Kindle Scribe 2025 support may not be possible. Does not work well currently.

NEW: PDF output is now supported for direct conversion to reMarkable devices! When using a reMarkable profile (Rmk1, Rmk2, RmkPP), the format automatically defaults to PDF for optimal compatibility with your device's native PDF reader.

The absolute highest quality source files are print quality DRM-free PDFs from Kodansha/Humble Bundle/Fanatical, which can be directly converted by KCC.

Its main feature is various optional image processing steps to look good on eink screens, which have different requirements than normal LCD screens. Combining that with downscaling to your specific device's screen resolution can result in filesize reductions of hundreds of MB per volume with no visible quality loss on eink. This can also improve battery life, page turn speed, and general performance on underpowered ereaders with small memory and storage capacities.

KCC avoids many common formatting issues (some of which occur even on the Kindle Store), such as: 1) faded black levels causing unneccessarily low contrast, which is hard to see and can cause eyestrain. 2) unneccessary margins at the bottom of the screen 3) Not utilizing the full 1860x2480 resolution of the 10" Kindle Scribe 4) incorrect page turn direction for manga that's read right to left 5) unaligned two page spreads in landscape, where pages are shifted over by 1 6) Removing without blur the rainbow effect on color eink Kaleido 3 due to manga screentones

The GUI looks like this, built in Qt6, with my most commonly used settings:

image

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. You can change the default output directory by holding Shift while clicking the convert button. 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.

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

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

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

Donate PayPal

  • Paweł Jastrzębski (active 2013-2019):

Donate PayPal Donate Bitcoin

  • Alex Xu (active 2023-Present)

ko-fi

Commissions

This section is subject to change:

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

Sponsors

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 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?
  • 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 Kindles. CBZ for Kindle DX. CBZ for Koreader. KEPUB for Kobo. PDF for ReMarkable or Kindle Scribe 2025.
  • 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

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", (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", (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", (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, K34, K578, KDX, KPW, KPW5, KV, KO, K11, KS, KoMT, KoG, KoGHD, KoA, KoAHD, KoAH2O, KoAO, KoN, KoC, KoCC, KoL, KoLC, KoF, KoS, KoE) [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 -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 earlie

Core symbols most depended-on inside this repo

addMessage
called by 22
kindlecomicconverter/KCC_gui.py
getint
called by 14
kindlecomicconverter/dualmetafix.py
addFile
called by 13
kindlecomicconverter/comicarchive.py
getImageFileName
called by 12
kindlecomicconverter/shared.py
cleanData
called by 11
kindlecomicconverter/KCC_gui.py
subprocess_run
called by 10
kindlecomicconverter/shared.py
getOutputFilename
called by 7
kindlecomicconverter/comic2ebook.py
sync
called by 7
kindlecomicconverter/KCC_gui.py

Shape

Method 134
Function 85
Class 25

Languages

Python100%

Modules by API surface

kindlecomicconverter/KCC_gui.py82 symbols
kindlecomicconverter/comic2ebook.py40 symbols
kindlecomicconverter/image.py33 symbols
kindlecomicconverter/shared.py13 symbols
setup.py12 symbols
kindlecomicconverter/dualmetafix.py12 symbols
kindlecomicconverter/comicarchive.py7 symbols
kindlecomicconverter/rainbow_artifacts_eraser.py6 symbols
kindlecomicconverter/comic2panel.py6 symbols
kindlecomicconverter/page_number_crop_alg.py5 symbols
kindlecomicconverter/pdfjpgextract.py4 symbols
kindlecomicconverter/metadata.py4 symbols

Dependencies from manifests, versioned

Pillow11.3.0 · 1×
PyMuPDF1.18.0 · 1×
PySide66.4.3 · 1×
distro1.9.0 · 1×
mozjpeg-lossless-optimization1.2.0 · 1×
natsort8.4.0 · 1×
numpy1.22.4 · 1×
packaging26.2 · 1×
psutil7.2.2 · 1×
python-slugify8.0.4 · 1×
requests2.34.2 · 1×

For agents

$ claude mcp add kcc \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact