docs/tools/cbz-to-pdf.md
Turn comic book archive files into PDFs. CBZ and CBR are the standard formats for digital comics -- they are just ZIP or RAR archives filled with images. This tool extracts each page, preserves the reading order, and produces a clean PDF where every image becomes a full-size page.
| Format | Extension | Notes |
|---|---|---|
| CBZ | .cbz | ZIP-based comic archive (processed locally with pdf-lib) |
| CBR | .cbr | RAR-based comic archive (processed via PyMuPDF engine) |
The CBZ converter recognizes JPEG, PNG, GIF, BMP, WebP, AVIF, TIFF, HEIC, and JXL images inside the archive. Non-standard formats are auto-converted to PNG before embedding.
comic-converted.zip.No configuration is required. Each image becomes a page sized to match its original dimensions, so double-page spreads stay wide and single pages stay narrow.
page2.jpg comes before page10.jpg). Name your files with consistent numbering for correct page sequence..jpg will still embed correctly.