Connecting a reader
Replace books.example.com below with this server's address. Sign-in is the username and password you were given; there is no self-registration.
The catalog
The catalog is OPDS 2.0, at https://books.example.com/opds/2.0. Give that address, with your username and password, to any reader that speaks OPDS 2.0: a recent KOReader, CrossPoint or Thorium. Readers that only speak the older OPDS 1.2 cannot use it.
In KOReader: Search → OPDS catalog → +, with the title tsundoku and the address above. Long-press a book to download it.
KOReader — progress sync
- Tools → More tools → Progress sync
- Custom sync server: https://books.example.com — the base address, with no path after it.
- Choose Login, not Register. Registration is disabled and refuses.
- Sign in with the same account on every device, the web reader included. Positions are kept per account.
- Set Document matching method the same on every device. binary is the default and the right choice; filename breaks as soon as you rename a file.
- Turn on Send document metadata if you want titles to appear beside positions in the web UI.
Reading in the browser
Click a book's cover or title in the library. Turn pages with the arrow keys, or tap the left or right third of the page. EPUB and CBZ positions sync with KOReader: put the book down on your e-reader and pick it up on your phone where you stopped, and the other way round. For that, every device needs the same copy of the book: download it from this catalog rather than sideloading a copy from elsewhere.
The Aa button sets the font, theme, text size, spacing, line length, columns, margins and the status bar. The font is saved to your account; the rest to this browser. The same settings, with a preview, are under Preferences.
Checking it by hand
curl -u you:secret https://books.example.com/opds/2.0 curl -u you:secret https://books.example.com/opds/2.0/new curl https://books.example.com/healthcheck