Calibre-Web in KOReader Over OPDS: Browsing and Downloading Your Library Without a Cable
Mira Chen
November 15, 2026
If you keep your ebooks in Calibre-Web and read them in KOReader, you don’t need a USB cable or email to get a book onto your device. KOReader includes an OPDS client, and Calibre-Web publishes an OPDS catalogue of your library. Connect the two once, and you can browse shelves, search titles and download books directly on the e-reader over Wi-Fi.
This guide walks through setting it up, from the Calibre-Web side to KOReader’s catalogue screen, and covers the problems that most often stop it working: login prompts, HTTPS certificates, download folders and covers. It applies to KOReader on Kobo and Kindle devices as well as on Android e-ink tablets.
What OPDS actually gives you
OPDS (Open Publication Distribution System) is a simple, open standard for publishing book catalogues as feeds. A reading app that supports OPDS can show a catalogue as a list of navigable folders, such as “Recently added”, “Authors” or “Series”, and download a book in one of its available formats with a tap.
It doesn’t sync your library automatically or push new books to the device. You browse and pull the books you want. For many readers that’s exactly right: the library stays on the server, and the e-reader only holds what you’re reading now.
If you haven’t chosen a library server yet, our comparisons of Calibre vs Calibre-Web and Calibre-Web Automated vs Calibre-Web cover the options. Everything below also works with Calibre-Web Automated, which keeps the same OPDS feed.
Step 1: confirm the catalogue works in a browser
Calibre-Web serves its OPDS feed at the /opds path of your server. If you open Calibre-Web at http://192.168.1.20:8083, the catalogue is at:
http://192.168.1.20:8083/opds
Open that address in a desktop browser first. You should be asked for a username and password, which are your Calibre-Web login, and then see an XML feed listing sections such as “Recently added books”, “Authors” and “Shelves”. If you get an error or a blank page here, KOReader won’t do any better, so fix this first.
Two settings in Calibre-Web matter:
- User permissions. The account you use must be allowed to download books. In the user’s settings, check that the download permission is enabled.
- Anonymous browsing. If you have enabled anonymous browsing, the catalogue may open without a login, but downloads still depend on the permissions of the guest user. For a private library, keep anonymous browsing off and use a dedicated account for the e-reader.
Creating a separate Calibre-Web user for each device, such as “kobo-sage”, makes it easy to revoke access if a device is lost, without touching your main account.

Step 2: add the catalogue in KOReader
- Open KOReader’s file browser.
- Tap the search icon in the top menu and choose OPDS catalog. (The exact menu position has moved between KOReader versions; if you don’t see it, look in the top menu’s tabs.)
- Tap the + button to add a catalogue.
- Enter a name such as “Home library”, the full URL including
/opds, and your Calibre-Web username and password. - Save, then tap the new entry to open it.
You should see the same sections as in the browser. Tap into “Recently added” or “Authors”, choose a book, and KOReader offers the available formats. Choose EPUB for most books. KOReader also handles PDF, CBZ, FB2, MOBI and more.
Step 3: choose where downloads go
By default KOReader saves OPDS downloads to its home folder or a downloads folder, depending on the device and version. Set a download directory you’ll actually find again. In the OPDS screen’s menu there is an option to choose the download folder. Many people point it at a “Books” or “Library” folder that matches how they browse in the file manager.
On Kobo devices running KOReader alongside the stock software, keep KOReader’s downloads in a folder the Kobo software ignores if you don’t want them appearing in both libraries. Our guide on Kobo syncing after installing KOReader explains how the two coexist.
HTTPS, certificates and reaching the library away from home
On your home network, plain HTTP to the server’s local address is the simplest and most reliable setup. Problems start when you want to download books on holiday.
- Self-signed certificates often fail on e-readers, because the device won’t trust them and KOReader can’t easily add exceptions. Use a real certificate, for example from Let’s Encrypt through your reverse proxy, if you expose the library over HTTPS.
- Old devices may lack modern root certificates or TLS versions. If a catalogue works on a newer device but not an old Kindle, this is a likely cause.
- Reverse proxies with extra login pages, such as Authelia or Authentik forward-auth, block OPDS clients that only know HTTP basic authentication. Add a bypass rule for the
/opdspath that still relies on Calibre-Web’s own login, or keep remote access on a VPN.
A VPN such as WireGuard or a mesh VPN on the e-reader isn’t practical on most devices. The usual answer is either HTTPS with a valid certificate and strong passwords, or simply downloading a few books before you leave home.

Covers, metadata and search
The OPDS feed includes cover thumbnails and basic metadata from Calibre-Web. KOReader shows covers in the catalogue if the feed provides them, which is pleasant but slower on large libraries over Wi-Fi. If browsing feels sluggish, use the search option inside the catalogue instead of scrolling long author lists. Calibre-Web’s OPDS feed supports search, so typing part of a title or author is the fastest way to a specific book.
Metadata quality in the catalogue is only as good as the library itself. Clean titles, author names and series information in Calibre-Web make browsing on a small e-ink screen much easier. Spending an evening fixing series numbers pays off every time you browse from the device.
Reading progress is a separate service
OPDS moves books, not reading positions. If you read the same book on several devices and want KOReader to remember your page across them, that’s KOReader’s progress sync feature, which uses a separate sync server. You can use the public server or run your own. Recent versions of Calibre-Web Automated also include a compatible sync endpoint, so check its documentation if you already run it. We covered KOReader’s sync settings in setting up KOReader on a Boox tablet.
Calibre’s own content server works the same way
If you run desktop Calibre rather than Calibre-Web, you can still use OPDS. Calibre’s built-in content server, started from the “Connect/share” menu, also publishes an OPDS feed at the /opds path of its address, for example http://192.168.1.10:8080/opds. Add it to KOReader in exactly the same way. The difference is that the desktop computer has to be on and Calibre running whenever you want to browse, which is why many people eventually move to a server like Calibre-Web.
KOReader also has a separate wireless connection to desktop Calibre, which makes the e-reader appear as a device inside Calibre so you can send books from the desktop. That’s handy for pushing a batch of books in one go, while OPDS is better for picking a single book from the e-reader itself.
A routine for a large library
With hundreds or thousands of books, browsing on a small e-ink screen gets slow. A few habits keep it pleasant:
- Create a Calibre-Web shelf called “To read on e-reader” and add books to it from your computer or phone. On the e-reader, open only that shelf in the catalogue.
- Use search for specific titles rather than scrolling author lists.
- Delete finished books from the device. They stay in the library on the server, and you can download them again in seconds.
This keeps the e-reader fast and uncluttered, with the server acting as the permanent home for your collection.
When it doesn’t work
- “Authentication required” or a loop of login prompts: recheck the username and password in KOReader’s catalogue entry, and confirm the same login works at
/opdsin a browser. - Catalogue opens but downloads fail: the user lacks download permission in Calibre-Web, or the book file is missing on the server.
- Works at home, fails outside: a certificate, reverse proxy or port-forwarding issue. Test from a phone on mobile data with a browser first.
- Timeouts on large libraries: use search rather than browsing “All books”, and check that the server isn’t asleep or overloaded.
If you also have comics or manga, the same approach works with Kavita or Komga, which publish OPDS feeds too. See Kavita vs Komga. Once a catalogue is set up, getting a new book onto your e-reader takes less time than finding the cable used to.
One last tip: add the same catalogue to every KOReader device in the house, each with its own Calibre-Web user. Everyone browses the same library, downloads what they want, and nobody needs to ask the person who runs the server to copy a book across. If a device is lost or sold, disable its user in Calibre-Web, and the rest of the household carries on as before.