Readwyn 0.1.0

How to sync a Kobo with a Mac without calibre

Plug the Kobo into your Mac with a USB cable and Readwyn opens its Sync screen with the changes in each direction already counted. It reads the Kobo’s own database, so calibre doesn’t need to be installed at all. If you came from calibre, your library is imported once, and calibre’s metadata.db is never read after that.

When you plug it in

Plugging the Kobo in only reads it. Nothing is written until you apply a sync. A card for the Kobo appears in the sidebar with a count of pending changes, for example “Connected · 13 changes”, and its “Review changes” button opens the Sync screen.

At the top of that screen is a drawing of your model, its name, “Connected over USB”, and a line with the number of books on it, the free space, the firmware version, and the date of your first sync.

The Sync screen of a Kobo Clara 2E: the device, the cards Device → Readwyn with 8 changes and Readwyn → Device with 5 changes, and the books that are not in the library
The Sync screen: one card for each direction

If you’d rather the Sync screen didn’t open by itself, set “When an e-reader connects” in Settings › E-readers to “Stay where I am”. The sidebar card still shows the Kobo and its changes. In the Mac App Store build, the first connection also asks you to give Readwyn access to the Kobo.

Two directions

Every sync runs one way, and Readwyn is always one end of it. Under “Choose what to sync” there are two cards, each with its own count. Both directions carry the same things; only the source changes. “Device → Readwyn” copies the Kobo’s values into the library, and “Readwyn → Device” copies the library’s values to the Kobo.

Where the two sides disagree, the receiving side ends up with the sender’s value. So the usual session is Device → Readwyn first, then Readwyn → Device, and the post on reading progress shows what happens the other way round. You can also run just one.

Review, then apply

The card’s button, for example “Review 8 changes”, doesn’t apply anything yet: it opens a review sheet that lists every change book by book, each row with its own checkbox. Most rows start ticked. Two kinds don’t: one whose receiving side was changed more recently, and a progress or time-read row that would move the Kobo back. Untick anything you don’t want and click the main button, say “Apply 7 changes”.

Afterwards a message gives the count, for example “Applied 7 changes from Kobo Clara 2E.” After a Readwyn → Device sync, which writes to the Kobo, it adds “The device database is backed up.”

When you’re done, click “Eject device” at the top of the Sync screen. Readwyn won’t eject the Kobo in the middle of a write.

What gets synced

A sync only touches books that are both in your library and in the Kobo’s database. For each of them it carries:

  • highlights and notes, with their colours,
  • status, progress with the last-read date, rating, and time read,
  • shelves, which become Kobo collections of the same name,
  • the words of My Words.

It never adds a book to the Kobo and never deletes one. Putting a book on the Kobo is a separate step, “Send to device” on the book screen (sending books to a Kobo).

Books that calibre put on the Kobo

If you used calibre to load your Kobo, there’s a file called metadata.calibre on it. Readwyn uses that file to work out which book on the Kobo is which book in your library: the calibre import kept each book’s calibre UUID for exactly this. If the file is missing or damaged, Readwyn falls back to matching on the title and first author.