Libbee is a plugin for KOReader that connects to your Libby / OverDrive account, allowing you to browse your library shelf and download borrowed ebooks directly to your device.
Libbee brings your public library loans directly into KOReader. With integrated native Adobe ADEPT fulfillment and DRM support, Libbee downloads and decrypts .acsm loan tokens on-device into readable EPUB and PDF files without requiring separate companion plugins or a computer.
| Grid View | List View |
|---|---|
![]() | ![]() |
- Direct Shelf Access: Browse all active ebook loans from your connected Libby shelf directly within KOReader.
- On-Device ACSM Fulfillment: Automatically fulfills and decrypts Adobe DRM
.acsmloans to standard.epuband.pdffiles on the device. - In-App Early Returns: Return loans early directly to your library within KOReader to immediately free up loan slots and clean up local files.
- Automatic Loan Expiration: Automatically removes downloaded book files 1 day after the loan expiration date while preserving reading progress, bookmarks, and highlights.
- Multi-Library & Multi-Card Support: Seamlessly browse and manage loans across multiple cards and library systems linked to your Libby account.
- Anonymous Device Activation: Ready to use out of the box with automatic one-time anonymous device activation.
- Optional ByteBooks Multi-Device Sync: Sign in with a ByteBooks ID to synchronize and read the same loan across multiple authorized devices.
- Cover and Metadata Display: View book titles, authors, cover art, format badges, and remaining loan duration.
- Grid and List Views: Flexible shelf presentation tailored for e-ink and high-resolution screens.
- Offline Shelf Cache: Cached shelf metadata allows offline browsing of currently borrowed titles.
- In-App Diagnostic Log Viewer: View sync, download, and error logs directly on device without connecting to a computer.
- Over-The-Air (OTA) Updates: Automatic and manual update checks via GitHub Releases with preservation of user settings.
Comprehensive guides, setup instructions, and feature details are available on the Libbee Wiki:
- Installation Guide: Step-by-step setup for e-readers and devices, plus update instructions.
- Authentication and Setup: How to link your Libby account using the 8-digit setup code displayed in KOReader.
- DRM and Fulfillment: Detailed explanation of on-device ACSM fulfillment and ByteBooks multi-device sync.
- User Interface and Features: Guide to shelf navigation, view modes, cover caching, and offline reading.
- Configuration Reference: Reference for all configuration options and default download paths.
- Troubleshooting and FAQ: Solutions for common errors, network issues, and general questions.
- Libbee interacts with OverDrive APIs using standard chip identity authentication mechanisms.
- The plugin accesses only active loans associated with your authorized library cards.
- Credentials and authentication tokens are stored locally on your device.
- Use of this plugin is subject to your library system's OverDrive Terms of Service.
- acsm.koplugin by Kai Kozlov — Core on-device Adobe ADEPT fulfillment and ACSM decryption logic.
- Bee icon created by Magnific — Flaticon.
This project is licensed under the MIT License. See the LICENSE file for details.

