Readwyn 0.1.0

Browse your ebook library in Thorium Reader

Thorium can open your Readwyn library as an OPDS catalogue. Give it the address, user name, and password that Readwyn makes for it, and you can browse your books by author, series, or shelf and download the ones you want to read in Thorium.

Thorium is one of the three apps that Readwyn names in its own settings. Under “Reader apps” in Settings › Other devices, the line below the switch reads “Reader apps such as KOReader, Thorium or Moon+ Reader can browse the libraries of this Mac and download books. They change nothing.” With “Readwyn server” on, switch the catalogue on, add a reader app called “Thorium” so its row is easy to spot later, and copy what the next sheet shows into Thorium. The KOReader post goes through every screen.

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, and the list of reader apps with Add a reader app
The address that Thorium needs

If Thorium runs on this same Mac, leave “Listen on” at “This Mac only”. The address is then http://127.0.0.1:7314/opds, and the note under it says “Only apps on this Mac can reach the catalogue.” Nothing goes over the Wi-Fi, the password included. Thorium on another computer needs your network picked in “Listen on” first.

Only KOReader has been tried against the catalogue so far, but every feed passes the Atom and OPDS 1.2 checks in Readwyn’s tests.

What you’ll find

If you keep one library, Thorium opens straight into it. Otherwise the first list is your libraries, each with its book count. Inside a library there’s Recently added (newest first), By author, By series, By shelf, and All books. An author or a shelf lists its books by title, and a series lists them in series order.

Your Readwyn shelves come across as they are, so a shelf you made for your book club becomes a list of its own. The catalogue’s search matches titles, authors, and series, exactly as the search on Readwyn’s library screen does, so a search from Thorium should turn up the same books. Long lists arrive 50 books at a time.

What a book entry carries

Each entry has the cover, title, authors, languages, publisher, publication date, ISBN, and genres. OPDS 1.2 has no field for a series, so Readwyn puts it at the top of the book’s text, for example “The Expanse, book 2”, with the description below. The description keeps its paragraphs, line breaks, bold, and italics; any other formatting is stripped.

Under all that are the downloads, each with its file type and size. A converted book offers its EPUB 3 and the original (which one to take). A comic offers only its CBZ, CB7, or CBT archive.