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

  1. Tools → More tools → Progress sync
  2. Custom sync server: https://books.example.com — the base address, with no path after it.
  3. Choose Login, not Register. Registration is disabled and refuses.
  4. Sign in with the same account on every device, the web reader included. Positions are kept per account.
  5. 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.
  6. 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