Skip to content

Commit 7ada985

Browse files
SimonSchubertSimonSchubert
committed
Add commands
1 parent 2029d6e commit 7ada985

4 files changed

Lines changed: 272 additions & 0 deletions

File tree

‎assets/commands/index.txt‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3899,6 +3899,8 @@ kb.md
38993899
kbt.md
39003900
kcadm.sh.md
39013901
kcat.md
3902+
kcc-c2e.md
3903+
kcc-c2p.md
39023904
kcmshell6.md
39033905
kdash.md
39043906
kde-builder.md

‎assets/commands/kcc-c2e.md‎

Lines changed: 178 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,178 @@
1+
# TAGLINE
2+
3+
convert comics and manga for e-ink readers
4+
5+
# TLDR
6+
7+
Convert a **CBZ** using the default Kindle Voyage profile
8+
9+
```kcc-c2e [comic.cbz]```
10+
11+
Target a **Kindle Paperwhite 5**
12+
13+
```kcc-c2e -p KPW5 [comic.cbz]```
14+
15+
**Manga** layout (right-to-left reading and splitting)
16+
17+
```kcc-c2e -m -p KV [manga.cbz]```
18+
19+
**EPUB/KEPUB** for a Kobo Clara
20+
21+
```kcc-c2e -p KoC -f EPUB [comic.cbz]```
22+
23+
**CBZ** for KOReader (no KindleGen)
24+
25+
```kcc-c2e -p KV -f CBZ [comic.cbz]```
26+
27+
**PDF** for a reMarkable 2
28+
29+
```kcc-c2e -p Rmk2 -f PDF [comic.cbz]```
30+
31+
Set **title and author** and write to a directory
32+
33+
```kcc-c2e -t "[Title]" -a "[Author]" -o [output/] [comic.cbz]```
34+
35+
Keep **color** (do not convert to grayscale)
36+
37+
```kcc-c2e --forcecolor -p KCS [comic.cbz]```
38+
39+
**Webtoon** processing
40+
41+
```kcc-c2e -w -p KV [webtoon.cbz]```
42+
43+
# SYNOPSIS
44+
45+
**kcc-c2e** [_options_] _input_...
46+
47+
# DESCRIPTION
48+
49+
**kcc-c2e** is the command-line comic-to-ebook converter from **Kindle Comic Converter** (KCC). It rebuilds comics and manga as fixed-layout files sized to a specific e-ink screen: pages fill the display without extra margins, blacks are leveled for e-ink, and two-page spreads can be split or rotated. Despite the Kindle-oriented name, it also targets Kobo, reMarkable, and other readers.
50+
51+
Input may be a folder of PNG, JPG, GIF, or WebP images; a CBZ, CBR, CB7, ZIP, RAR, or 7Z archive (archive formats other than a simple ZIP typically need **7z** on PATH); a PDF (images are extracted or rendered); or an EPUB. Output is **MOBI**/**AZW3** (Kindle), **EPUB** (plain **.epub** or Kobo **.kepub.epub**), **CBZ**, **PDF**, **KFX**, or **MOBI+EPUB**. With **-f Auto** (the default), Kindle profiles produce MOBI, Kobo profiles produce EPUB/KEPUB, reMarkable profiles produce PDF, and Kindle DX produces CBZ.
52+
53+
The generated **.mobi** is a dual MOBI/AZW3 container; the **.mobi** extension is kept for compatibility. MOBI and KFX conversion need Amazon **kindlegen** (commonly installed with Kindle Previewer). KOReader users can skip KindleGen by writing CBZ instead.
54+
55+
A Qt GUI is installed as **kcc** (not a shell converter). **kcc-c2p** is a companion CLI that splits tall images into device-height pages.
56+
57+
# PARAMETERS
58+
59+
**-p** _PROFILE_, **--profile** _PROFILE_
60+
> Device profile. Default **KV** (Kindle Voyage, 1072x1448). Kindle examples: **K1**, **K2**, **K34**, **K57**, **K810**, **KDX**, **KPW**, **KV**, **KPW34**, **KPW5**, **KPW6**, **KO**, **K11**, **KCS**, **KS**, **KS3**, **KSCS**. Kobo examples: **KoMT**, **KoG**, **KoGHD**, **KoA**, **KoAHD**, **KoAH2O**, **KoAO**, **KoN**, **KoC**, **KoCC**, **KoL**, **KoLC**, **KoF**, **KoS**, **KoE**. reMarkable: **Rmk1**, **Rmk2**, **RmkPP**, **RmkPPMove**. **OTHER** is an empty custom profile (use **--customwidth** / **--customheight**). Run **-h** for the list shipped with this version.
61+
62+
**-m**, **--manga-style**
63+
> Right-to-left reading and split order (manga). For CBZ output, page-turn direction is still set by the reader.
64+
65+
**-w**, **--webtoon**
66+
> Webtoon processing (tall strip layout). Default max output size is 100 MB instead of 400 MB.
67+
68+
**-f** _FORMAT_, **--format** _FORMAT_
69+
> Output format: **Auto**, **MOBI**, **EPUB**, **CBZ**, **PDF**, **KFX**, or **MOBI+EPUB**. Default **Auto**.
70+
71+
**-o** _PATH_, **--output** _PATH_
72+
> Output directory or file. Default is next to the input.
73+
74+
**-t** _TITLE_, **--title** _TITLE_
75+
> Comic title. Default is the input file or directory name (or ComicInfo.xml / PDF metadata when **--metadatatitle** is set).
76+
77+
**-a** _AUTHOR_, **--author** _AUTHOR_
78+
> Author. Default **KCC**, or ComicInfo.xml / PDF author when present.
79+
80+
**--language** _LANG_
81+
> EPUB language tag. Default **en-US**.
82+
83+
**--nokepub**
84+
> With EPUB output, write **.epub** instead of **.kepub.epub**.
85+
86+
**-b** _N_, **--batchsplit** _N_
87+
> Split large output: **0** none (default), **1** automatic by size, **2** treat each subdirectory as a volume. MOBI/KFX always split unless **2** is used.
88+
89+
**--ts** _MB_, **--targetsize** _MB_
90+
> Maximum output size in MB. Default 400 (100 for webtoon; 95 for reMarkable if unset).
91+
92+
**-r** _N_, **--splitter** _N_
93+
> Double-page handling: **0** split (default), **1** rotate, **2** both.
94+
95+
**-c** _N_, **--cropping** _N_
96+
> Cropping: **0** off, **1** margins, **2** margins and page numbers (default).
97+
98+
**-u**, **--upscale**
99+
> Upscale images smaller than the device resolution.
100+
101+
**-s**, **--stretch**
102+
> Stretch images to the device resolution.
103+
104+
**-n**, **--noprocessing**
105+
> Do not modify images; ignore profile and processing options.
106+
107+
**--forcecolor**
108+
> Keep color; do not convert pages to grayscale.
109+
110+
**--forcepng**
111+
> Write PNG instead of JPEG for black-and-white images (better on jailbroken Kindles with KOReader; can cause blank pages on some stock Kindle firmware).
112+
113+
**--webp**
114+
> Write lossy WebP instead of JPEG and lossless WebP instead of PNG.
115+
116+
**--eraserainbow**
117+
> Reduce rainbow/moire artifacts on color e-ink (Kaleido) by attenuating interfering frequencies.
118+
119+
**-q**, **--hq**
120+
> Increase magnification quality (larger images for panel view).
121+
122+
**-2**, **--two-panel**
123+
> Two panels instead of four in Kindle panel view.
124+
125+
**--lightnovel**
126+
> Only resize images and keep the original file structure.
127+
128+
**--ebok**
129+
> Force the MOBI **EBOK** book type instead of **PDOC**.
130+
131+
**--customwidth** _PX_, **--customheight** _PX_
132+
> Override the profile screen size.
133+
134+
**-d**, **--delete**
135+
> Delete the source file or directory after conversion. Not recoverable.
136+
137+
**-h**, **--help**
138+
> Print the full option list and exit.
139+
140+
# CAVEATS
141+
142+
Not Amazon's **Kindle Comic Creator**, and not endorsed by Amazon.
143+
144+
MOBI/KFX output needs **kindlegen**. Without it, conversion stops at EPUB. CBZ and PDF do not need KindleGen.
145+
146+
Do not open or edit KCC output in **Calibre**. Calibre does not handle this fixed-layout MOBI/EPUB correctly and can break layout and page numbers. Copy the file onto the device over USB (typically the **documents** folder).
147+
148+
Kindle Scribe 2025 MOBI often shows blank pages; PDF is the recommended output. PNG on Kindle Scribe and several formats on Kindle Colorsoft can also blank pages; JPEG is safer on stock firmware.
149+
150+
The CLI exposes combinations that can reduce quality. Prefer a matching **-p** profile over a generic size.
151+
152+
**7z** is optional but much faster, and required for some archive types and features.
153+
154+
Re-converting a file already produced by KCC degrades quality.
155+
156+
# HISTORY
157+
158+
**Kindle Comic Converter** was started in **2012** by **Ciro Mattia Gonano** as a cross-platform alternative to **KindleComicParser**. **Paweł Jastrzębski** (AcidWeb) maintained it from **2013** to **2019**, with later work by **Darodi** and **Alex Xu** (from **2023**). It is written in Python and released under the ISC License. **kcc-c2e** is the comic2ebook CLI; current package version is **11.0.3** (2026).
159+
160+
# INSTALL
161+
162+
```aur: yay -S kcc```
163+
164+
```nix: nix profile install nixpkgs#kcc```
165+
166+
<!-- packages: 2026-09-01 -->
167+
168+
# SEE ALSO
169+
170+
[kcc-c2p](/man/kcc-c2p)(1), [ebook-convert](/man/ebook-convert)(1), [calibre](/man/calibre)(1), [7z](/man/7z)(1)
171+
172+
# RESOURCES
173+
174+
```[Source code](https://github.com/ciromattia/kcc)```
175+
176+
```[Documentation](https://github.com/ciromattia/kcc/wiki)```
177+
178+
<!-- verified: 2026-09-01 -->

‎assets/commands/kcc-c2p.md‎

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
# TAGLINE
2+
3+
split tall comic images into device-height pages
4+
5+
# TLDR
6+
7+
Split images in a folder to a **1448-pixel** screen height (mutates the folder)
8+
9+
```kcc-c2p -y 1448 [path/to/pages]```
10+
11+
Also set **width** (used when computing virtual page height)
12+
13+
```kcc-c2p -y 1448 -x 1072 [path/to/pages]```
14+
15+
**Merge** every subdirectory into one tall image, then split
16+
17+
```kcc-c2p -y 1448 -m [path/to/chapter-folders]```
18+
19+
Write **debug overlays** showing detected panel bounds
20+
21+
```kcc-c2p -y 1448 -d [path/to/pages]```
22+
23+
# SYNOPSIS
24+
25+
**kcc-c2p** [**-y** _height_] [**-x** _width_] [**-i**] [**-m**] [**-d**] [_input_...]
26+
27+
# DESCRIPTION
28+
29+
**kcc-c2p** is the command-line comic-to-panel splitter from **Kindle Comic Converter** (KCC). It walks directories of raster images, detects panel-like regions in tall pages, and cuts them into new PNG pages that fit a target screen height. That is useful for webtoon-style strips and oversized scans before loading them on an e-reader.
30+
31+
Input must be one or more **directories** of images, not a CBZ/CBR/PDF. Non-image files in those trees are removed. Detected panels that exceed the target height are split (with overlap on very tall panels). The original image is deleted after a successful split.
32+
33+
The Qt GUI is **kcc**. Full ebook conversion (MOBI, EPUB, CBZ, PDF, device profiles) is **kcc-c2e**, which also has a **-w** webtoon mode. Use **kcc-c2p** when you only need to slice folders of images.
34+
35+
**-y** is required. With no input, or with an empty input list, the tool prints help and exits **1**.
36+
37+
# PARAMETERS
38+
39+
**-y** _HEIGHT_, **--height** _HEIGHT_
40+
> Target device screen height in pixels. Required. Conversion is skipped with an error if this is unset or **0**.
41+
42+
**-x** _WIDTH_, **--width** _WIDTH_
43+
> Target device screen width in pixels. Used when computing a virtual height cap (widths above 1072 are scaled down internally).
44+
45+
**-i**, **--in-place**
46+
> Declared as "overwrite source directory". Current **11.0.3** always writes into the input tree and does not branch on this flag.
47+
48+
**-m**, **--merge**
49+
> Combine every directory into a single image before splitting. Directories that would exceed a very large combined height (on the order of hundreds of thousands of pixels) fail instead of merging.
50+
51+
**-d**, **--debug**
52+
> Write a ***-debug.png** overlay for each split image showing detected panel rectangles.
53+
54+
**-h**, **--help**
55+
> Print help and exit.
56+
57+
# CAVEATS
58+
59+
Only directories of images are accepted. Convert archives with **kcc-c2e** or extract them first.
60+
61+
The tool always works in the input directory. Successful splits **delete** the source image after writing the new PNG pages. Copy the tree first if you need the originals.
62+
63+
Work is parallelized with a process pool. A worker crash aborts the run and may delete the target tree.
64+
65+
This is a preprocessor, not a full ebook converter: there is no device profile, no MOBI/EPUB output, and no KindleGen step.
66+
67+
# HISTORY
68+
69+
**kcc-c2p** is the comic2panel CLI from **Kindle Comic Converter**, started in **2012** by **Ciro Mattia Gonano** and later maintained by **Paweł Jastrzębski**, **Darodi**, and **Alex Xu**. Python, ISC License. Current package version is **11.0.3** (2026).
70+
71+
# INSTALL
72+
73+
```aur: yay -S kcc```
74+
75+
```nix: nix profile install nixpkgs#kcc```
76+
77+
<!-- packages: 2026-09-01 -->
78+
79+
# SEE ALSO
80+
81+
[kcc-c2e](/man/kcc-c2e)(1), [ebook-convert](/man/ebook-convert)(1), [convert](/man/convert)(1)
82+
83+
# RESOURCES
84+
85+
```[Source code](https://github.com/ciromattia/kcc)```
86+
87+
```[Documentation](https://github.com/ciromattia/kcc/wiki)```
88+
89+
<!-- verified: 2026-09-01 -->

‎scripts/fetch-package-installs.py‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,9 @@
116116
},
117117
"babel": {"brew": "babel"},
118118
"air": {"aur": "air", "nix": "air"}, # not brew (R formatter)
119+
# kcc-c2e/kcc-c2p: Fedora "kcc" is Kanji Code Converter, not Kindle Comic Converter
120+
"kcc-c2e": {"aur": "kcc", "nix": "kcc"},
121+
"kcc-c2p": {"aur": "kcc", "nix": "kcc"},
119122
"alembic": {"apk": "py3-alembic", "nix": "python3Packages.alembic"},
120123
# backintime: CLI binary is in backintime-common on Debian/Fedora (arch:all, missed by Contents-amd64)
121124
"backintime": {

0 commit comments

Comments
 (0)