Readwyn 0.1.0

How to put CBZ comics on a Kobo from a Mac

Kobo e-readers open CBZ files themselves, so a comic needs no conversion to get there. Connect the Kobo to your Mac with a USB cable and tap Connect on its screen. Open the comic in Readwyn, click “…” (“More actions”) on its book screen, and choose “Send to device”. Eject the Kobo when the send ends, and the comic turns up in My Books once the Kobo has imported it.

What the Kobo reads

Kobo's list of supported file formats gives two comic formats for its e-readers: CBZ and CBR. Of the two, Readwyn only ever sends CBZ. A CBZ goes over as the very file you added. A CB7 or CBT goes as its reading copy, a CBZ that Readwyn keeps in its cache with page images byte for byte the same as the original's.

The setting “Convert EPUB to KEPUB for Kobo e-readers” makes no difference here. It applies to ebooks; comics always go as CBZ, never as KEPUB.

Where the file lands

Readwyn names the file after the comic's first author and title, in the Kobo's Books folder:

Books/<first author> - <title>.cbz

Those names come from the library, so for a comic with a ComicInfo.xml inside, the author is the first Writer, else the first Penciller, else the first CoverArtist. A comic with no author at all goes as Books/Unknown - <title>.cbz. A colon, a slash, a question mark, or another character that a file name on the Kobo can't hold becomes an underscore. If the file name on the Kobo matters to you, fix the author and title in Readwyn before you send.

While the Kobo is connected and has the file, the item in the “…” menu reads “Send to device again”, and the book screen's Details tab shows a row, “On the device”, with the copy on the Kobo and a “Remove from device” button.

Why it isn't in My Books yet

A send copies the file and nothing more. Readwyn writes no row for the comic to the Kobo's database, KoboReader.sqlite; the Kobo adds that row itself when it leaves USB mode. Until then the file sits on the Kobo's storage, and Readwyn already counts it as on the device.

So eject before you unplug. “Eject device” on the Sync screen does it for you. If Readwyn is still writing, it says so first (“Readwyn is still writing to the Kobo”), and “Stop and eject” waits up to 30 seconds for the write to end. If the write is still going after that, the Kobo stays connected and Readwyn asks you to try again. Kobo's own guide to copying files from a computer says what happens next on the device: an “Importing content” message, and then the book is under My Books on the Home screen. If the comic still doesn't show up, the causes are much the same as for an EPUB that doesn't show on a Kobo, and ejecting a Kobo from a Mac covers the eject itself.

WebP pages

Readwyn reads comic pages in JPEG, PNG, GIF, and WebP, and it never re-encodes a page, so what's in your archive is what reaches the Kobo. Kobo's format list names JPEG, GIF, PNG, BMP, and TIFF as the image files its e-readers open. WebP isn't on it, and the page says nothing about the images inside a comic archive. If a comic of yours has WebP pages, open it on the Kobo before you count on reading it there.

CBR files

Readwyn doesn't take CBR, the RAR flavour of comic archive, because the licence of the RAR decoder isn't one that the Open Source Initiative has approved. A CBR can't go through “Send to device”, even though the Kobo lists CBR as a format it reads.

More than one comic

“Send to device” goes one book at a time, from each book screen. The selection bar for many books doesn't offer it, so a run of twelve issues means twelve sends before you eject. Sending books to a Kobo goes through the whole send for ebooks too, and keeping comics and ebooks in one library covers what a comic looks like in Readwyn before it ever reaches the device.