docs/tools/pdf-to-cbz.md
Converts a PDF into a CBZ (Comic Book ZIP) file — the standard format for digital comics and manga. Each PDF page becomes an image inside the archive. The tool generates metadata in three formats for maximum compatibility: ComicInfo.xml, metadata.opf, and ComicBookInfo JSON.
.cbz file downloads automatically.| Option | Values | Default | Description |
|---|---|---|---|
| Image Format | JPEG, PNG, WebP | JPEG | JPEG for color comics, PNG for lossless B&W manga, WebP for best compression. |
| Quality | 50–100% | 85% | Controls JPEG/WebP compression. Hidden for PNG (always lossless). |
| Scale | 1.0x–4.0x | 2.0x | Higher scale produces sharper images for high-res screens. |
| Grayscale | On/Off | Off | Converts pages to grayscale. Reduces file size for B&W content. |
| Manga mode | On/Off | Off | Sets right-to-left reading direction in metadata. |
| Include metadata | On/Off | On | Embeds ComicInfo.xml, metadata.opf, and ComicBookInfo JSON. |
When metadata is enabled, you can fill in:
The tool writes metadata in three formats so every reader can find it:
| Format | Location | Supported by |
|---|---|---|
| ComicInfo.xml | File inside ZIP | Komga, Kavita, CDisplayEx, Mylar, ComicRack |
| metadata.opf | File inside ZIP | Calibre |
| ComicBookInfo JSON | ZIP comment field | Calibre (fallback) |
filename.cbz — A ZIP archive containing numbered page images and metadata files.Page images are named with zero-padded numbers (01.jpg, 02.jpg, etc.) so readers display them in the correct order.