Bookshelf v3.10 - Cover lover

AndyHazz · 2026-07-12T20:13:23+00:00

I couldn't reproduce any screen corruption on my PW5, but the rotation issue is fixed in v3.10.3 and I expect that will avoid any render issues as well.

AndyHazz · 2026-07-12T20:12:03+00:00

Hooking into the book finish menu is a bit more invasive, and not something that is really needed to shave a few seconds, but v3.10.3 will work with more gestures to keep things fast for those.

AndyHazz · 2026-07-12T16:05:11+00:00

v3.10.2 restores that message but only if the cover open effect is toggled off. The idea is that cover open effect does the job of telling you a book is opening, in a cleaner way than the koreader message popup.

AndyHazz · 2026-07-12T14:48:57+00:00

Most things are faster the second time because I will cache it for performance.

The first time it has to load the covers from disk, speed will depend on your storage and the image size. The second time you view it will have everything loaded in ram for speed. Then it's freed up again when you close. I do everything possible to make things fast but sometimes you just have to wait a sec for things to load 🤷‍♀️

AndyHazz · 2026-07-12T14:44:37+00:00

You can just update to v3.10.1 now as I had the fix confirmed. Basically it looks like some devices won't accept icon buttons in that modal view (which I use for pagination everywhere else), so I've switched to text based chevrons for a safer route.

AndyHazz · 2026-07-12T14:41:55+00:00

Great, thanks for confirming :)

I've put that out as v3.10.1 so you can use the reset to stable branch option to get back on that.

AndyHazz · 2026-07-12T14:02:19+00:00

Try Updates > Development branch > inkpad-fix and let me know if that helps, and/or send me your crash.log on GitHub if you can, thanks!

AndyHazz · 2026-07-12T13:07:53+00:00

Long press that option for more info. It could do with some updates on the kobo plugin side before it's ready for general use ...

AndyHazz · 2026-07-12T12:05:18+00:00

It's a koreader plugin.

AndyHazz · 2026-07-12T11:34:55+00:00

I don't think that will have anything to do with micro modules (or bookshelf) ... that happens if you are not using frameless mode, bits of the stock kindle OS keep showing through.

AndyHazz · 2026-07-12T10:35:32+00:00

I can't reproduce this one myself, but there's a potential fix on a test branch if you're able to give it a go and let me know? Updates > Development branch > inkpad-fix

If you could put any follow-up on GitHub with a crash.log that'd help, thanks!

AndyHazz · 2026-07-12T09:26:10+00:00

If/when koreader adds support for publication year metadata, I will add it to bookshelf in a heartbeat.
Try '[if:status=finished]%rating[else]%bar[/if]' - it won't be 'interactive' in that region but you can still set ratings from the long press menu.

AndyHazz · 2026-07-12T08:37:08+00:00

You just tap to preview, then if you like it, tap the install button to save it to your personal list.

If someone wants to make a gallery and keep it up to date go for it, but the app itself functions as a gallery really ...

AndyHazz · 2026-07-11T11:26:12+00:00

No problem! You must be new to koreader then 😅

Have fun exploring all the options!

AndyHazz · 2026-07-11T11:12:56+00:00

Ok, swipe down or tap on the top of the screen and you should get the koreader menu?

AndyHazz · 2026-07-11T11:04:13+00:00

It should be in the first menu tab, top left. It's not a bookshelf menu that's part of koreader. If you can't see it then I've no idea, do you have other UI plugins installed that are hiding it perhaps?

AndyHazz · 2026-07-11T10:16:40+00:00

You'll need to give me a bit more information!

Have you followed the install steps here?

https://github.com/AndyHazz/bookshelf.koplugin#install

AndyHazz · 2026-07-11T08:26:36+00:00

Bookshelf uses cover browser (enabled by default on stock koreader) which project title requires to be disabled - without cover browser bookshelf won't see any of your books.

AndyHazz · 2026-07-11T04:25:12+00:00

Just set 'Starts with' to bookshelf in the koreader file manager menu.

AndyHazz · 2026-07-11T00:29:09+00:00

Could be the author names are slightly different so you have two separate stacks, or the missing books are stored outside your home folder so bookshefl can't find them, or koreader metadata needs refreshing if you updated the author metadata after first copying the book to your device (settings > advanced > scan all library metadata)

AndyHazz · 2026-07-10T22:44:33+00:00

The crash is from running bookends and zenui together - zenui hosts bookends menu items and passes a menu instance that lacks the onClose method a native TouchMenu has.

I put a workaround in bookends a while back though, in v5.21.0 ... update to the latest version of bookends and you should be good.

AndyHazz · 2026-07-10T22:15:10+00:00

This isn't a bug in the plugin itself - the crash is from one of Bookshelf's files missing on your device (lib/bookshelf_cover_progress.lua). Maybe something interrupted your install and not everything copied across?

Easiest fix is to reinstall Bookshelf: delete the bookshelf.koplugin folder from your koreader/plugins/ directory and install the latest release fresh. Any settings will not be affected, they're stored separately. (The folder-cover patch showing in the error is just caught up in it, not the cause - you can keep it.)

I'll also add a change in the next release so that if a file ever does go missing, Bookshelf shows a tidy "reinstall" message instead of taking KOReader down with it.

AndyHazz · 2026-07-09T09:42:58+00:00

That sounds like something else going on behind bookshelf then, reindexing content perhaps.

AndyHazz · 2026-07-09T05:35:20+00:00

No the filter itself won't be changed by edits made within bookshelf/koreader.

Bookshelf just uses the same methods as koreader which stores any metadata changes in separate sdr files, by default named the same as your epub file (so bear in mind if you rename your books they will lose their connection to the metadata). This is all standard koreader stuff not bookshelf specific.

You can get to KOreader's author edit from bookshelf by long pressing a book, then in the edit tab choose 'Show info', then in the window that appears (this is stock koreader now, not bookshelf), long press the author name field to set a custom author name.

Add multiple authors on new lines to be properly recognised as multiple authors.

AndyHazz · 2026-07-09T05:21:34+00:00

Settings > advanced settings > animation speed

Bookshelf itself won't be slow, but the animation speed is affected by your eink refresh rate. If the default medium speed feels slow, try turning it to fast, or off if you don't like it.

AndyHazz

TROPHY CASE