OPDS

Voltis serves OPDS catalogs so reading apps can browse your libraries, lists and search results, download comics and books, and stream comic pages.

Keys and feed URLs

OPDS apps sign in with a per-user key instead of a session. Create one under Settings → OPDS, one per app or device. The key's link button shows its two feed URLs:

Feed	URL	Use with
OPDS 1.2	https://voltis.example.com/opds/<key>/v1.2/catalog	KOReader, Panels, Chunky and other apps that support OPDS-PSE
OPDS 2.0	https://voltis.example.com/opds/<key>/v2/catalog	Readium-based apps, such as Thorium

Pick 1.2 unless your app only speaks 2.0: page streaming and progress sync exist only in the 1.2 feed.

The key is a password

The key is part of the URL, so anyone who sees the URL can read your libraries and change your progress.

Signing out, changing your password or changing your linked identity does not revoke your keys.

Reading progress

Apps that stream comics page by page through OPDS-PSE update your progress as they fetch pages:

• Progress only moves forward. Going back to an earlier page leaves it where it was.
• Fetching the last page marks the comic completed, unless its status is already something other than reading.

Reverse proxies

Feed links are absolute. Behind a proxy that rewrites the Host header, set app.public_url so the links point at the address apps connect to.

With forwarded authentication, apps cannot get past your proxy's login page. Let /opds/ through without authentication: the key in the path authenticates those requests, and Voltis ignores identity headers there. In Caddy, handle that path before the forward_auth route:

handle /opds/* {
	reverse_proxy voltis:8080
}