bookshelf.koplugin

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/AndyHazz/bookshelf.koplugin/master/assets/bookshelf-logo-dark.png">
    <img alt="Bookshelf" src="https://raw.githubusercontent.com/AndyHazz/bookshelf.koplugin/master/assets/bookshelf-logo.png" width="320">
  </picture>
</p>

# Bookshelf

A friendly home screen for KOReader. Browse your library by series, author, genre, collection, or anything you like; pick a book, glance at its cover, blurb, rating and progress, and start reading. Shelves draw three ways: a grid of covers, a list, or spines standing edge-on like a real bookcase.

<p align="center">
  <img src="assets/screenshot-shelf-spines.png" width="19%" alt="Home as spines, dressed in the Autumn theme pack" />
  <img src="assets/screenshot-shelf-list.png" width="19%" alt="Recent books as a list" />
  <img src="assets/screenshot-shelf-stacks.png" width="19%" alt="Series as stacks of covers" />
  <img src="assets/screenshot-shelf-covers.png" width="19%" alt="Inside the Fiction genre: a grid of covers" />
  <img src="assets/screenshot-fullscreen-covers.png" width="19%" alt="A full-screen grid of covers" />
</p>

<p align="center"><b><a href="https://andyhazz.github.io/bookshelf-docs/">Read the user guide</a></b>: installing, every feature, every setting, with videos.</p>

## Install

Bookshelf needs **KOReader v2025.08 or newer**, and works best on v2026.03 or newer (**Help > Version** in KOReader's menu). New to KOReader? The guide has [links to the official install guides](https://andyhazz.github.io/bookshelf-docs/get-started/koreader/) for every device.

1. Download **bookshelf.koplugin.zip** from [Releases](https://github.com/AndyHazz/bookshelf.koplugin/releases/latest) (not the green Code button).
2. Unzip it into KOReader's plugins folder:

   | Device | Plugins folder |
   |--------|----------------|
   | Kindle | `koreader/plugins/` |
   | Kobo | `.adds/koreader/plugins/` |
   | PocketBook | `applications/koreader/plugins/` |
   | Android | `koreader/plugins/` in internal storage |

3. Restart KOReader.
4. To open on your shelf every time: in KOReader's file browser menu, first tab, set **Start with** to **bookshelf**.

Bookshelf needs KOReader's **Cover browser** plugin, which is on in a normal KOReader. Updates install from inside KOReader: **Bookshelf > Updates**.

More detail, and what to do if it doesn't appear: [Install Bookshelf](https://andyhazz.github.io/bookshelf-docs/get-started/install/).

## The guide

| | |
|---|---|
| [**Get started**](https://andyhazz.github.io/bookshelf-docs/get-started/) | Install KOReader and Bookshelf, your home folder, opening on start-up, your first five minutes, and what changes if you know KOReader already. |
| [**Use your shelf**](https://andyhazz.github.io/bookshelf-docs/use/) | Covers, lists and spines; moving around; the book menu; search; the start menu. |
| [**Organise**](https://andyhazz.github.io/bookshelf-docs/organi