How to read CBZ comics on a Mac
Drop the CBZ on Readwyn's window, or use “Add books”, then click “Read” on the comic's book screen. It opens in the page reader, and nothing gets converted: the CBZ you added is the only file the book has.
Adding comics
Comics from a calibre library come in with the rest of the import. A CBZ is a ZIP archive of page images in JPEG, PNG, GIF, or WebP, and Readwyn will also take a plain .zip as a CBZ if it holds page images and isn't an EPUB or an OEB package.
The pages are the images in the archive, sorted the way a person would sort the names, so page2.jpg comes before page10.jpg. Anything that isn't an image is left out, and so is the __MACOSX folder. An archive with no page images at all isn't added, and the toast after the import says why. A comic with one broken page still comes in and opens.
If there's a ComicInfo.xml inside, Readwyn takes the title, the writers and artists, the series and its number, and the cover from it. The ComicInfo.xml post goes through every field.
In the library a comic looks like any other book, and its book screen gives the exact page count from the archive (“24 pages”) instead of an estimate. Because the archive is never converted, “Send to device” copies that same CBZ to a Kobo, under Books/<first author> - <title>.cbz, and the Kobo opens it as it is.
Reading
Once you've started a comic, the button says “Continue reading” and opens it where you stopped. A wide window shows two pages side by side, with the cover and any double-page spread on their own. If you'd rather see one page at a time, choose “Always one page” in Settings › Reading.
- “Fit page”, the default, shows the whole spread. “Fit width” makes one page as wide as the window, and you scroll down it.
- ⌘= and ⌘- zoom, ⌘0 goes back to the fit, and a pinch works too.
- Space, Page Down, the left and right arrow keys, and the round buttons beside the pages turn the page. Shift+Space and Page Up go back, and Escape closes the comic.

The footer shows the page you're on (“p. 7 of 24”), how far through you are as a percentage, and the minutes left. Press or drag on the track to jump to a page. The time left comes from your reading speed in pages per minute, which Readwyn learns as you read comics.
A comic is pictures, so there's no find, no dictionary lookup, and no highlighting in the page reader, and its book screen has no Highlights tab.
Large archives
A 1 GB CBZ of 1,000 uncompressed 1 MB pages, timed on a Mac with the file already in the disk cache, took 5.9 ms to scan and 3.5 ms to open, and one page took 0.17 ms to read. The reader unpacks just the current spread and two pages on either side of it, and decodes only the pages around the one you're on.