Sync & Backup

Reading across multiple devices shouldn't mean losing your place. Readest keeps books, progress, highlights, and notes in step through several sync paths — you can use any of them on its own, or layer them.

Cloud sync

Sign in to a Readest account under Main Menu → Account. Once signed in, Sync toggles appear in the menu.

Readest is open-source and self-hostable. If you want full control over sync storage, see the repo for setup details. The Supabase schema is documented on the wiki.

Sync with Koreader

If you also use Koreader (a popular reader for e-ink devices), you can sync reading progress between Readest and Koreader. There are two ways — pick the one that matches what you need:

Progress only (official KOSync server)

Uses the official KOReader Sync Server. Works for progress only.

In Readest:

1. Open a book → Book Menu → KOReader Sync.
2. Enter the server URL — defaults to https://sync.koreader.rocks/.
3. Enter your username and password.
4. Set Checksum method to File Content.

In Koreader:

1. Tools → Progress sync.
2. Enter the same URL, username, and password.
3. Set Document matching to Binary.

Progress now syncs both ways. Bookmarks, highlights, and notes do not sync via this path — the official server supports progress only.

Progress + notes (Readest Sync + plugin)

Uses a Readest account on both sides.

1. Install the Readest Sync KOReader plugin from the plugin page.
2. Sign in to the same Readest account on both apps.
3. In Koreader's Readest Sync menu, do a manual Push / Pull to test connectivity.
4. Enable auto-sync once you've confirmed the pair works.

This path syncs progress, bookmarks, highlights, and notes. File sync is planned.

The Readest Sync Server does not currently support backward syncing — if one device has a later progress mark, it won't regress even if another device tries to sync an earlier one. Override from the server if you need to.

Full setup guide: the Sync with Koreader devices wiki page.

Readwise export

Readest can push highlights and notes to Readwise.

1. Book Menu → Readwise Sync.
2. Paste your Readwise access token.
3. Tap Push Highlights to send all new highlights automatically to Readwise.

Exports include the book title, author, chapter, quote, note, and source link back into the Readest book.

Hardcover tracking

Hardcover tracks what you're reading, rating, and finishing. Readest can update Hardcover automatically.

1. Book Menu → Hardcover Sync.
2. Paste your Hardcover API key.
3. Match each book in your library to a Hardcover title (done by ISBN where possible, manually otherwise).
4. Toggle Enable for this book per book.

When the toggle is on, you can push progress and notes as you read to Hardcover.

Backup & restore

Even with cloud sync on, a local backup is a good idea for heavy annotators.

• Export annotations — from the Book Menu (per-book). See Reading → Highlights & notes for export formats.
• Export library data — under Main Menu → Advanced Settings → Backup & Restore, export a zip file of your library: book files, metadata, reading status, groups, highlights and notes.

To restore on a new device, import the backup zip file and it will restore your library and all your reading data. Cloud sync, if you use it, will re-align everything automatically after restore.