mirror of
https://github.com/ciromattia/kcc
synced 2026-08-22 19:47:06 +00:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
1d9758d4bd | ||
|
|
3e6cbcb91d | ||
|
|
2bae809e5f |
@@ -58,7 +58,7 @@ jobs:
|
|||||||
name: windows-build-${{ matrix.entry }}
|
name: windows-build-${{ matrix.entry }}
|
||||||
path: dist/*.exe
|
path: dist/*.exe
|
||||||
- id: optional_step_id
|
- id: optional_step_id
|
||||||
uses: signpath/github-action-submit-signing-request@v2.2
|
uses: signpath/github-action-submit-signing-request@v2.3
|
||||||
if: ${{ github.repository == 'ciromattia/kcc' }}
|
if: ${{ github.repository == 'ciromattia/kcc' }}
|
||||||
with:
|
with:
|
||||||
api-token: '${{ secrets.SIGNPATH_API_TOKEN }}'
|
api-token: '${{ secrets.SIGNPATH_API_TOKEN }}'
|
||||||
|
|||||||
@@ -51,7 +51,7 @@ jobs:
|
|||||||
name: windows7-build
|
name: windows7-build
|
||||||
path: dist/*.exe
|
path: dist/*.exe
|
||||||
- id: optional_step_id
|
- id: optional_step_id
|
||||||
uses: signpath/github-action-submit-signing-request@v2.2
|
uses: signpath/github-action-submit-signing-request@v2.3
|
||||||
if: ${{ github.repository == 'ciromattia/kcc' }}
|
if: ${{ github.repository == 'ciromattia/kcc' }}
|
||||||
with:
|
with:
|
||||||
api-token: '${{ secrets.SIGNPATH_API_TOKEN }}'
|
api-token: '${{ secrets.SIGNPATH_API_TOKEN }}'
|
||||||
|
|||||||
@@ -1,8 +1,4 @@
|
|||||||
Most manga conversion methods for ereaders add margins. But KCC enables true fullscreen from top to bottom.
|
<img src="header.jpg" alt="Header Image" width="400">
|
||||||
|
|
||||||
<img src="header_margins.jpeg" alt="Header Image">
|
|
||||||
|
|
||||||
(feat. Ya Boy Kongming! [Humble Bundle](https://humblebundleinc.sjv.io/xL6Zv1) PDF source.)
|
|
||||||
|
|
||||||
# KCC
|
# KCC
|
||||||
|
|
||||||
@@ -15,68 +11,54 @@ Most manga conversion methods for ereaders add margins. But KCC enables true ful
|
|||||||
like Kindle, Kobo, ReMarkable, and more.
|
like Kindle, Kobo, ReMarkable, and more.
|
||||||
Pages display in fullscreen without margins,
|
Pages display in fullscreen without margins,
|
||||||
with proper fixed layout support.
|
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, or PDFs.
|
||||||
|
|
||||||
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.
|
Supported output formats include MOBI/AZW3, EPUB, KEPUB, CBZ, and PDF.
|
||||||
|
KCC runs on Windows, macOS, and Linux.
|
||||||
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
|
|
||||||
|
|
||||||
<img src="black.jpeg" alt="Black level">
|
|
||||||
|
|
||||||
(feat. Fire Force)
|
|
||||||
|
|
||||||
3) fixes [the rainbow effect on Kaleido 3 color eink](https://www.youtube.com/watch?v=Dw2HTJCGMhw) without blur:
|
|
||||||
|
|
||||||
<img src="rainbow2.jpeg" alt="Rainbow">
|
|
||||||
|
|
||||||
Just drop your input files into the KCC window, hit convert, and USB drop the output files onto your device's `documents` folder!
|
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
|
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!
|
**WARNING**: Kindle Scribe 2025 support may not be possible. Does not work well currently.
|
||||||
|
|
||||||
The final result looks incredible on my 10" Kindle Scribe: https://www.youtube.com/watch?v=2CIHW2N9Enc
|
**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.
|
||||||
|
|
||||||
**WARNING**: Kindle Scribe 2025 MOBI support may have blank pages. Use PDF instead.
|
The absolute highest quality source files are print quality DRM-free PDFs from Kodansha/[Humble Bundle](https://humblebundleinc.sjv.io/xL6Zv1)/Fanatical,
|
||||||
|
which can be directly converted by KCC.
|
||||||
|
|
||||||
The GUI looks like this, built in Qt6. There are a lot of options, but most people only care about the ones checked below:
|
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](https://github.com/ciromattia/kcc/wiki/Kindle-Store-bad-formatting)), 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
|
||||||
|
7) Fixing page order problems due to Windows sort being different than Kindle/Kobo sort
|
||||||
|
|
||||||
|
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,
|
Simply drag and drop your files/folders into the KCC window,
|
||||||
adjust your settings (hover over each option to see details in a tooltip),
|
adjust your settings (hover over each option to see details in a tooltip),
|
||||||
and hit convert to create ereader optimized files.
|
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.
|
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.
|
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
|
YouTube tutorial (please subscribe): https://www.youtube.com/watch?v=QQ6zJcMF2Iw
|
||||||
|
|
||||||
Installation tutorial: https://www.youtube.com/watch?v=IR2Fhcm9658
|
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
|
### 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.
|
**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.
|
Amazon's tool is for comic publishers and involves a lot of manual effort, while **KCC** is for comic/manga readers.
|
||||||
|
|||||||
BIN
Binary file not shown.
|
Before Width: | Height: | Size: 351 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 398 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 358 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 178 KiB |
Reference in New Issue
Block a user