back to home

ciromattia / kcc

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

4,884 stars
321 forks
62 issues
PythonDockerfileShell

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing ciromattia/kcc in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/ciromattia/kcc)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

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. Supported input formats include JPG/PNG image files in folders, archives, 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 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: 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 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): • Paweł Jastrzębski (active 2013-2019): • Alex Xu (active 2023-Present) Commissions This section is subject to change: Email (for commisions and inquiries): 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 • (Windows) • (recent Mac with Apple Silicon M1 chip or later) • (older Mac with Intel chip macOS 14+) There are also legacy macOS 10.14+ and Windows 7 experimental versions available. The and versions are command line tools for power users. On macOS, if you get a 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. Viewing KCC output in Calibre will also not work properly. On 7th gen and later Kindles running firmware 5.15.1+, you can get cover thumbnails simply by USB dropping into documents folder. On 6th gen and older, you can get cover thumbnails by keeping Kindle plugged in during conversion. If you are careful to not modify the file however, you can still use Calibre, but 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. 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. • 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…