Browse your ebook library from your phone on the home network
Your phone can browse the Readwyn library on your Mac if it has a reader app for OPDS 1.2 catalogues and is on the same home Wi-Fi. Whether the phone gets through at all comes down to one setting, “Listen on”, and until you change it only apps on the Mac itself can reach the catalogue.
Let the phone reach the Mac
In Settings › Other devices on the Mac, turn on “Readwyn server” and look at “Listen on”. It starts as “This Mac only”. If the catalogue is already on, the Reader apps section warns:
“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.”
Choose the network your phone is on. Readwyn lists the Mac’s networks the way System Settings › Network names them, each with the Mac’s address on it, for example “Wi-Fi · 192.168.1.20”.
macOS may ask whether Readwyn can accept incoming connections. Allow it, or the phone can’t get in.
Turn on the catalogue
Under “Reader apps”, turn on “Share with reader apps (OPDS)”. The address appears with a Copy button, for example http://192.168.1.20:7314/opds. Click “Add a reader app…”, name it after your phone, and type the address, user name, and password from the next sheet into the reader app. Readwyn’s own test used KOReader, so that’s the app the step-by-step post follows.
The phone can then browse your libraries by author, series, or shelf and download books (every feed it can open). It can’t change anything, though, and your reading status and progress stay on the Mac. If you want to read on another Mac and keep your progress, pair that Mac instead: Share one ebook library between two Macs.
What the warnings mean
Once a network is chosen, two warnings appear. The one under “Listen on” is about other Macs: “Anything on your Wi-Fi can reach this Mac. Only paired devices can open the libraries.” The one under the address is about reader apps:
“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.”
The catalogue uses plain HTTP with Basic authentication, not HTTPS, because many reader apps refuse a self-signed certificate. Every request has to carry one reader app’s user name and password, and a request without them is refused with HTTP 401. Since the password crosses the network unencrypted, turn this on at home only, never on a café or hotel network.
Away from home
The catalogue works on your home network only. Readwyn offers no access from outside it and runs no server on the internet for you, so download what you want to read before you leave.
You don’t need the Readwyn window open, though. With “Readwyn server” on, the server keeps running after you quit Readwyn and starts again at login.
Check that the phone got through
The list of reader apps shows “Never connected” until the phone’s first request, then “Last connected today”. If it stays at “Never connected”, check that the phone is on the same Wi-Fi and that “Listen on” names that network.