Readwyn 0.1.0

Set up an OPDS catalogue for KOReader

KOReader can browse the libraries on your Mac and download books from them, because Readwyn serves those libraries as an OPDS catalogue. You switch the catalogue on in Readwyn, add KOReader as a reader app, and type the address, user name, and password that Readwyn gives you into KOReader. Nothing from Readwyn has to be installed on the e-reader.

Turn on the catalogue

The catalogue is part of Readwyn server, so it runs on the Mac that keeps your libraries. In Settings › Other devices:

  1. Turn on “Readwyn server”.
  2. In “Listen on”, pick the network your e-reader uses, for example “Wi-Fi · 192.168.1.20”.
  3. Under “Reader apps”, turn on “Share with reader apps (OPDS)”. It stays off until you do.

If Listen on is still “This Mac only”, the Reader apps section says “Only apps on this Mac can reach the catalogue. To reach it from a phone or an e-reader, choose a network in Listen on.” Once you’ve picked a network, the address below the switch uses it, for example http://192.168.1.20:7314/opds, with a Copy button.

Settings › Other devices › Reader apps: the switch Share with reader apps (OPDS) is on, the address http://192.168.1.20:7314/opds with Copy, a warning about the Wi-Fi, and three reader apps, the first named Kindle Scribe KOReader
Settings › Other devices › Reader apps

Add KOReader as a reader app

Every reader app gets a user name and password of its own. Click “Add a reader app…” and name it after the device, for example “Kindle Scribe KOReader”. Readwyn turns that into the user name kindle-scribe-koreader.

The same sheet has “Show Currently reading”, which is off by default. Tick it and KOReader also lists the books you’re reading now, most recent first. It still never sees your progress, ratings, or reviews.

The next sheet has “Kindle Scribe KOReader” at the top and, under it, “In the reader app, add an OPDS catalogue and type:”, followed by the address, user name, and password, each with a Copy button. Copy the password before you close it: “Shows only now. If you lose it, remove the reader app and add it again.” It looks like k7mq-2xfp-9rtw-hb3n, and it’s made to be typed on an e-reader (why it’s built that way).

What KOReader did in Readwyn’s test

Readwyn tested its catalogue with a macOS nightly build of KOReader from 20 October 2026, pointed at a test library. On 22 October, KOReader:

  • added the catalogue with its address, user name, and password,
  • listed Recently added, Currently reading, By author, By series, By shelf, and All books,
  • opened an author, a series, and a shelf,
  • found “kafka” with its search,
  • downloaded “Crime and Punishment” as EPUB 3 and opened it.

That book offered two downloads, “EPUB 3” first and “MOBI (original)” second. The file KOReader got was an EPUB 3 package (version="3.0"), the copy Readwyn had converted from the MOBI. Once the reader app was removed in Readwyn, the same user name and password got HTTP 401.

KOReader is the only reader app Readwyn has tested so far. On the Mac, the steps are the same for Thorium, Moon+ Reader, or any other app that reads OPDS 1.2.

After it’s connected

KOReader can download books and covers, and that’s all. The catalogue is read only, and a reader app has the Guest level, so the feeds carry no status, progress, rating, or review. What is OPDS? lists every feed it can open.

The catalogue is meant for your home network. It uses plain HTTP with Basic authentication, and the warning under the address says so: “Anything on your Wi-Fi can reach the catalogue, and the reader apps send their password in clear. Share only on a network you trust.”