Readwyn 0.1.0

Why a Kobo sync shows a preview before it changes anything

Because a Kobo sync in Readwyn goes one way. Wherever the Kobo and the library differ, the side you sync to (the target) takes the value of the side you sync from (the source), even when the source is behind, so a sync can move your progress back or replace a note you’d rather keep. Readwyn shows you every change first, book by book, and applies only the rows you leave ticked. Building that preview writes nothing.

One direction, no conflicts

One side is always Readwyn: “Device → Readwyn” or “Readwyn → Device”. There’s no conflict screen, because the direction decides.

The Sync screen counts each direction’s changes before you open anything, for example “8 changes in 3 books”, and each card has its own button, such as “Review 8 changes”. The line under “Choose what to sync” ends: “You see every change before anything is written.”

The Sync screen: the card Device → Readwyn with 8 changes in 3 books and Review 8 changes, and the card Readwyn → Device with 5 changes in 4 books and Review 5 changes
Each direction counts its changes before a review

Reading the review

The sheet groups the changes by book. A highlight or note shows its text and whether it’s added, updated or deleted. A reading value shows the field and both sides, as in “Update · Progress” with “18% → 22%”. Ratings appear as stars, and shelves and saved words get rows of their own (“Add · Shelf”, “Update · Word”). Both directions are tabs at the top of the sheet, each with its count, so you can switch between them without going back.

Almost every row starts ticked. Two kinds start unticked, and each says why. A row whose target changed more recently than the source shows the date, “changed here later, on 9 Oct”. A Readwyn → Device row that would move the Kobo back spells it out: “The Kobo is ahead. This moves it back to 18%. Run Device → Readwyn first to keep 22%.”

Every row has a checkbox, and so does each book, with a count such as “2 changes · 1 ticked”. The foot of the sheet keeps the total (“7 of 8 changes ticked”), and the button follows it: “Apply 7 changes”.

After the books comes “Left out”, the things the sync won’t do, each with its reason:

  • a saved word whose book isn’t on both sides
  • a book the library recorded on the Kobo that has since gone: “Not on the device. Send it from its book page first.”
  • a book on the Kobo with reading data or highlights that the library doesn’t have: “Not in this library.”
  • a highlight that has no place in the book on the Kobo

Two options at the top

“Merge highlights, notes and words instead of replacing them” is on by default. With it on, anything only the target has stays, and the review lists it as kept, so the sync deletes nothing. Turn it off and each synced book’s highlights, notes and words on the target become exactly the source’s, with every deletion listed.

In Device → Readwyn, “Keep finished books” stops the Kobo from changing the status, progress or time read of a book the library already has at 100%. Both options are set per Kobo, and you can change them for a single review.

After you apply

A Readwyn → Device sync backs up the Kobo’s database before it touches anything, then writes the ticked rows in one checked transaction. Device → Readwyn doesn’t write to that database, so it needs no backup. When either sync is done, a message at the foot of the screen gives the number of changes applied and, after a write to the Kobo, confirms the backup. That direction’s card then reads “Up to date” (“Applied 7 changes just now. 1 left unticked.”), and the other card counts its changes again. Each applied sync also goes into “Recent syncs” further down, with its time, its direction and what it left out.