AndyHazz

AndyHazz / bookshelf.koplugin

Public

A nice looking home screen for KOReader. Lets you pick a book from your shelf and read it, with some customisation around the book preview info that's shown.

18
1
100% credibility
Found May 09, 2026 at 18 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Lua
AI Summary

Bookshelf is a KOReader plugin that transforms the home screen into an attractive bookshelf interface for browsing books by categories like Recent, Latest, Series, and Favorites, with customizable previews and gestures.

How It Works

1
🔍 Discover Bookshelf

You find Bookshelf, a beautiful home screen for your e-reader app that organizes books into handy shelves like Recent and Favorites.

2
📥 Download and add it

Grab the ready-to-use folder from the releases page and place it in your e-reader's plugins area, then restart the app.

3
🏠 Welcome to your new shelf

Bookshelf opens as your home screen, showing colorful book covers grouped neatly on shelves you can tap to explore.

4
📚 Browse and pick a book

Swipe through Recent reads, Latest additions, Series stacks, or Favorites – tap any spine to jump into reading.

5
✏️ Make it yours

Tweak the big book preview to show just what you want, like progress bars or custom details, right from the menu.

😊 Your perfect reading hub

Now your e-reader feels cozy and personal, with all your books at a glance and easy ways to dive back in anytime.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 18 to 18 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is bookshelf.koplugin?

Bookshelf.koplugin turns KOReader's bland file manager into a nice looking bookshelf home screen, grouping your ebooks into shelves like Recent, Latest, Series, and Favourites so you can tap spines to jump into reading. It shows a customizable hero card preview with book details, progress bars, and device stats, all editable via token templates for title, author, or even battery life around the cover. Written in Lua as a KOReader plugin, it handles Kindle, Kobo, and Android devices out of the box.

Why is it gaining traction?

Its gesture-driven navigation—swipe to page or cycle previews, toggle 2/3-row grid—feels native on e-ink, while the editable hero regions let you tweak displays like "%book_pct %bar 3h LEFT" without coding. Self-updating over Wi-Fi and soft-deps on plugins like Bookends add polish, standing out from KOReader's stock UI by making library browsing visual and fast. Devs dig the clean GitHub repo with detailed gesture tables and token cheatsheets.

Who should use this?

KOReader users on e-readers tired of digging through folders for their next book—think daily commuters scanning Recent or Series shelves. It's for anyone customizing their reading setup, like tweaking progress bars or status lines, without wanting a full launcher replacement. Pairs well with Calibre libraries for metadata-rich previews.

Verdict

Solid pick for KOReader fans seeking a nicer home screen; install via ZIP and restart. At 18 stars and 1.0% credibility, it's early but docs are thorough—worth trying if you read often, though watch for updates on larger libraries.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.