OPDS Feed

Storyteller supports the OPDS protocol, which allows you to download and browse books from your library on devices that may not support the Storyteller apps.

Storyteller supports both OPDS v1.2 and v2.0.

Feed specifics

The feed is available at

• https://<storyteller-server>/opds/v1 for OPDS v1.2
• https://<storyteller-server>/opds/v2 for OPDS v2.0

Storyteller serves both audiobooks and epubs/readalouds through the OPDS feed. If a readaloud is available, it will be preferred over the EPUB.

You can check your feed, and validate other feeds, with our OPDS v2 Validator tool.

Most client will not be able to play audiobooks, the only currently tested client that can is Thorium Reader.

Authentication methods

Most OPDS clients support basic authentication. This is the default authentication method for Storyteller.

Storyteller also aims to comply with the OPDS Authentication 1.0 specification. Compatible clients will allow you to login with OAuth for instance.

As of 2026-01-03, Thorium Reader is the only client tested that supports the above spec.

Tested clients

Works

• Thorium Reader Only one who supports reading Readalouds and audiobooks, and OPDS v2.0 (from our testing)
• Cantook
• Boox PushRead (Images may not work)
• KOReader
• Yomu
• KyBook
• FBReader

Does not work

• MoonReader+ (Only tested on an older version)

Settings

For now there are only three settings available for OPDS:

• Enable OPDS feed: Whether to enable the OPDS feed.
• Enable pagination: Whether to enable pagination for the OPDS feed. Some clients (like Boox PushRead) do not support pagination. You can disable this to return all items in a single response.
• Page size: The number of items per page in the OPDS feed.
• Preferred ebook: Whether to offer the readaloud or the ebook for download.