Skip to main content

v2.6.0 with OPDS support

· 3 min read
Thomas F. K. Jorna
Thomas F. K. Jorna
Developer

Heya!

We're excited to announce the release of Storyteller v2.6.0! This release includes support for OPDS, which allows you to browse and download books from your library on devices that may not support the Storyteller apps.

Currently we only support OPDS v1.2, but we plan to support v2.0 in the future.

How to access​

The OPDS feed is available at https://<storyteller-server>/opds. Just add it to your OPDS client and you should be good to go!

Authentication methods​

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

At the time of writing, only Thorium Reader appears to implement this specification, all other clients tested only support basic authentication.

Settings​

There are 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.

Caveats​

Unfortunately, due to the nature of OPDS, while we can make your books available on devices that don't support the Storyteller apps, we can't keep track of your progress when you read books this way. For KOReader you could try using ABS-KoSync Bridge, which also syncs with Storyteller.

Tested clients​

These are the clients we've tested at time of writing. See the OPDS documentation for an up-to-date list of supported clients.

Works​

Storteller&#39;s OPDS feed in KOReader

Storteller&#39;s OPDS feed in Thorium Reader

Does not work​

  • MoonReader+ (Only tested on an older version, let us know if you can confirm it works with a newer version)

Troubleshooting & Feedback​

If you're having trouble accessing your library with OPDS, or if you want to see another client added to the list, feel free to reach out to us on Discord or open an issue on GitLab.