Most manga conversion methods for ereaders add margins. But KCC enables true fullscreen from top to bottom. (feat. Ya Boy Kongming! [Humble Bundle](https://humblebundleinc.sjv.io/xL6Zv1) PDF source.) # KCC [](https://github.com/ciromattia/kcc/releases) [](https://github.com/ciromattia/kcc/pkgs/container/kcc) [](https://github.com/ciromattia/kcc/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. 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](https://humblebundleinc.sjv.io/xL6Zv1)/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) 3) fixes [the rainbow effect on Kaleido 3 color eink](https://www.youtube.com/watch?v=Dw2HTJCGMhw) 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. 3) 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](http://www.amazon.com/gp/feature.html?ie=UTF8&docId=1001103761) 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](http://www.mobileread.com/forums/showthread.php?t=207461). If you have some **technical** problems using KCC please [file an issue here](https://github.com/ciromattia/kcc/issues/new). 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): [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=D8WNYNPBGDAS2) - Paweł Jastrzębski (active 2013-2019): [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=YTTJ4LK2JDHPS) [](https://jastrzeb.ski/donate/) - Alex Xu (active 2023-Present) [](https://ko-fi.com/Q5Q41BW8HS) ## 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](https://about.signpath.io/), certificate by [SignPath Foundation](https://signpath.org/) ## 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](https://github.com/ciromattia/kcc/issues/665) or [any format with a Kindle Colorsoft](https://github.com/ciromattia/kcc/issues/768). 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. - 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](https://www.amazon.com/gp/help/customer/display.html/ref=hp_Connect_USB_MTP?nodeId=TCUBEdEkbIhK07ysFu) (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](https://www.amazon.com/Kindle-Previewer/b?ie=UTF8&node=21381691011) 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](https://github.com/ciromattia/kcc/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: ``` /* Detailed source-code truncated for AI context efficiency. */ ``` ### Standalone `kcc-c2e.py` usage: ``` /* Detailed source-code truncated for AI context efficiency. */ ``` ### 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](https://desktop.github.com) 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](https://www.python.org) 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](https://code.visualstudio.com). 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](https://doc.qt.io/qt-6/designer-tab-order.html). 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: ``` 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](http://github.com/ciromattia) - [Paweł Jastrzębski](http://github.com/AcidWeb) - [Darodi](http://github.com/darodi) - [Alex Xu](http://github.com/axu2) This script born as a cross-platform alternative to `KindleComicParser` by **Dc5e** (published [here](http://www.mobileread.com/forums/showthread.php?t=192783)). 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](https://github.com/FooSoft/mangle/) with subsequent [proDOOMman](https://github.com/proDOOMman/Mangle)'s and [Birua](https://github.com/Birua/Mangle)'s patches. - Icon is by **Nikolay Verin** ([http://ncrow.deviantart.com/](http://ncrow.deviantart.com/)) and released under [CC BY-NC-SA 3.0](http://creativecommons.org/licenses/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](http://kcc.iosphe.re/Samples/Ubunchu!-KO.mobi) * [Kindle Paperwhite 3 / 4 / Voyage / Oasis](http://kcc.iosphe.re/Samples/Ubunchu!-KV.mobi) * [Kindle Paperwhite 1 / 2](http://kcc.iosphe.re/Samples/Ubunchu!-KPW.mobi) * [Kindle](http://kcc.iosphe.re/Samples/Ubunchu!-K578.mobi) * [Kobo Aura](http://kcc.iosphe.re/Samples/Ubunchu-KoA.kepub.epub) * [Kobo Aura HD](http://kcc.iosphe.re/Samples/Ubunchu-KoAHD.kepub.epub) * [Kobo Aura H2O](http://kcc.iosphe.re/Samples/Ubunchu-KoAH2O.kepub.epub) * [Kobo Aura ONE](http://kcc.iosphe.re/Samples/Ubunchu-KoAO.kepub.epub) * [Kobo Forma](http://kcc.iosphe.re/Samples/Ubunchu-KoF.kepub.epub) ## PRIVACY **KCC** is initiating internet connections in two cases: * During startup - Version check and announcement check. ## KNOWN ISSUES Please check [wiki page](https://github.com/ciromattia/kcc/wiki/Known-issues). ## COPYRIGHT Copyright (c) 2012-2025 Ciro Mattia Gonano, Paweł Jastrzębski, Darodi and Alex Xu. **KCC** is released under ISC LICENSE; see [LICENSE.txt](./LICENSE.txt) for further details. ## Verification Impact-Site-Verification: ffe48fc7-4f0c-40fd-bd2e-59f4d7205180