Readwyn 0.1.0

What happens to your Kobo sync after a factory reset

Readwyn treats the reset Kobo as a new device. Nothing you synced before is lost: highlights and notes with their context and pages, progress, status, time read, ratings, shelves and the words in My Words all stay on your Mac. Settings › E-readers keeps the old entry until you forget it, and the reset Kobo gets a fresh identity at its next sync or send.

Why the Kobo looks new

Readwyn recognises a Kobo by a random ID in one small file, .readwyn/device-id, on the Kobo’s main storage. The first applied sync or send writes that file and registers the Kobo in the library. From then on the library knows which of its books are on that Kobo and where, which syncs you applied (they’re what “Recent syncs” shows), and the date of the first sync, shown on the Sync screen as “syncing since”.

A factory reset wipes that file. Connecting the reset Kobo only reads it, so it has no ID until you apply a sync or send a book. The first sync or send after that writes a new ID and registers it as a new device, with today’s date for “syncing since”. Readwyn keeps each Kobo’s options on your Mac under its ID, so the reset Kobo starts with the defaults from Settings › E-readers. The library keeps its records for the old ID, and those are what the old entry in Settings › E-readers shows.

Putting books and highlights back

A sync never adds books to a Kobo. If the reset cleared yours, send them again with “Send to device” in the “…” menu of each book. Then eject the Kobo, let it add them, and connect it again: Readwyn won’t write to its database while it’s still adding books.

If you run Device → Readwyn first, leave “Merge highlights, notes and words instead of replacing them” on, as it is by default (what the option does). The reset Kobo has no highlights, so with the option off the review would list every highlight of each synced book for deletion. Books you haven’t opened on the reset Kobo have no reading values to give, so their progress in the library stays as it was.

Readwyn → Device is the one that refills the Kobo: highlights, notes, progress, ratings, shelves and saved words. The review shows every change first. A highlight that has no place in the book on the Kobo isn’t written, and the review names it with the reason.

Forgetting the old entry

Settings › E-readers lists every device that has synced with a library, even one that isn’t connected. After the first sync or send following the reset, you’ll see two entries, and both can have the same name. The new one shows “Connected” and “syncing since” today. The old one has no “Connected” and shows when it last synced. Choose “Forget…” on the old one, or “Rename…” first if you want to tell them apart.

Forgetting removes the device from every library: its record, its book paths, its syncs and its options on this Mac. The books and the reading data that came from it stay.

If you haven’t reset yet

Run Device → Readwyn first, so the library has the Kobo’s highlights, notes, words and reading values before they’re wiped.