OPDS support - koreader/koreader GitHub Wiki

This plugin adds an OPDS browser to the filemanager, which lets you browse public online OPDS catalogs and download ebooks from these. You can even add your own custom OPDS server. An overview of OPDS catalogs can be found in the MobileRead Wiki.

Note: In order to access an OPDS catalog search you have to go to:

  1. file browser (the OPDS catalog button is not available in book reading mode)
  2. "magnifying glass" toolbar icon
  3. OPDS menu item

OPDS catalog

OPDS catalog

How to access your own Calibre library on your wifi network using OPDS

1 In Calibre: Connect/Share > Start Content Server
-a) Note the address and port

2. In KOReader go to Search (magnifying glass) > OPDS Catalog

3. Tap on LOCAL CALIBRE LIBRARY (long-press if you wish to edit an existing connection)

4. Enter the following:

  • Calibre host: the address shown in Calibre (at 1a)
  • Port: the port (at 1a)

5. Tap on LOCAL CALIBRE LIBRARY again. You will see a list of parameters that will match various parameters in your Calibre library - including custom columns you created yourself. On newer version, there is an top-left plus sign button, tap on it, provide your favorite connection name and also provide URL to Calibre server content host. E.g.: "http://192.168.10.123:8080/opds".

Eg.

  • By Newest
  • By Title
  • By Authors
  • By Tags
  • By [your custom parameter]


  1. By tapping on one of these you will see the books that match that parameter

  2. Tapping on a book will bring up a dialog to allow you to download it

Notes

If either of these are running, it is not a problem:

  • KOReader: the wireless connection (via Tools > Connect)
  • Calibre: Connect/Share > 'Wireless device connection'

If Calibre is set to require authentication, it must use "basic" authentication, not "digest" authentication. Digest authentication is the default for unencrypted communications, but KOReader doesn't support digest authentication. See issue #3953. Warning: Unencrypted basic authentication is insecure. Anyone who can inspect your network traffic will be able to see your password. Only use basic authentication with SSL or when it's only run on a completely-trusted network without being exposed to the Internet.

⚠️ **GitHub.com Fallback** ⚠️