RereaderBlog

KOReader highlights, synced locally

KOReader — the open-source reader beloved on Kobo, jailbroken Kindles, and Android e-ink — ships a Readwise sync plugin. Point that plugin at a Readwise-compatible server running on your own Mac, and your KOReader highlights join your local library without touching anyone's cloud.

The trick: the API is a dialect, not a place

KOReader's "Readwise" integration just POSTs highlights to the Readwise v2 API shape. Anything that speaks that shape can receive them. Rereader serves exactly that API on your Mac — same endpoints, same field names — so KOReader can sync to localhost instead of readwise.io.

Setup

Get your Rereader API token

Rereader → Settings → Ingest API token → copy. This token is what KOReader will authenticate with.

Put your Mac and device on the same network

Rereader listens on your Mac. For a device to reach it over Wi-Fi, the server must be told to accept LAN connections (an environment switch documented in Settings' help), and you'll use your Mac's local IP — e.g. 192.168.1.20:4321 — instead of localhost.

Configure KOReader's Readwise plugin

In KOReader: Tools → Highlight sync (Readwise). Set the API token to your Rereader token, and where the plugin allows a custom endpoint, use http://YOUR-MAC-IP:4321/api/v2/highlights/.

Sync and verify

Trigger a sync from KOReader, then check Rereader's Import screen — the run appears with its added count, and the book shows up in your library.

Idempotent, like everything else: KOReader sends a stable identifier per highlight, so re-syncing the same book adds nothing twice.

Why bother?

Because it unifies the library. Kindle highlights arrive over USB, KOReader highlights over Wi-Fi, old Readwise archives by CSV — one searchable collection on your Mac, one daily email drawing from all of it. And none of it lives on a server you rent.

Your highlights deserve a second life

Rereader brings your Kindle highlights back — five in your inbox every morning, a two-minute review on your Mac. One-time purchase, no subscription, your data stays on your machine. 30-day refunds, no questions.

Get Rereader $19 once