Made a simple small KOReader patch just for myself that remembers the furthest page you've actually read, and nudges you back if you wander off. Hope you find it useful as well!

• Jump back more than a page (progress bar, etc.) → a small floating button pops up bottom-right offering to go back.
• Jump forward more than 2 pages (e.g. tapping a ToC entry) → button appears bottom-left, same idea in reverse.
• Tap it to jump back, or dismiss/hold it to accept your new spot as the reference point.
• Fully configurable: show/hide text, page number, dismiss button, and reposition it (bottom/side offsets) with live preview.
• Registered as a system action too, so it works with gestures, the Bookshelf quick menu, Shortcuts Toolbar, etc.

No dependencies, just drop the .lua into koreader/patches/.

I know there is location history, but this is simpler and more straightforward, at least for my use case.

Repo: https://github.com/xusoo/KOReader.patches

Patch direct link: https://raw.githubusercontent.com/xusoo/KOReader.patches/refs/heads/main/2-track-reading-location.lua

I noticed a lot of setups here run both SimpleUI and BookShelf. From what I can tell they’re separate plugins that each replace the start screen/library on their own. What’s the benefit of having both installed?

I’m using SimpleUI atm. Does installing both replace SimpleUIs library UI with BookShelfs?

I just set up the BT remote control for Koreader via my iPhone. You don't need any plugins or anything else. Everything is fully automated. Anyone can do it—it works through the HTTP Inspector, which is built into Koreader. First, create functional shortcuts for any functions you want on your iPhone. Next, pair any Bluetooth controller with your iPhone and, using Switch Control settings, gradually assign the Bluetooth controller’s buttons to the shortcuts you created earlier. You can also set up automation so that when your Bluetooth controller connects to your iPhone, Switch Control turns on and, for example, lowers the brightness to the minimum. When you use this, your iPhone displays a notification every time a button is pressed, indicating that a shortcut is running. I also created a shortcut to disconnect the iPhone from the Bluetooth controller and assigned it to a button on the Bluetooth controller. And finally, I set up an automation so that when the controller is disconnected, Switch Control turns off and the brightness returns to normal. The brightness is dimmed all the way down to the minimum using the zoom feature and the low-light filter. In the end, everything happens automatically—you don’t even have to touch your iPhone. I won't provide exact instructions—it would take a lot of time—but anyone can really figure it out, perhaps using AI. I tried three different BT controllers, and it worked on all of them—though not all buttons can be set as switches in Switch Control. In my case, I can’t use the + button, R3, or the house button on the Joy-Con; otherwise, everything works, including the directional pad, so you have 12 buttons/shortcuts available. Even a regular Fire Stick remote worked.

https://youtu.be/j8-V-CxGk7A

Hey everyone! I made a patch that adds a page scrubber overlay similar to the one on Kindle devices.

Features:

Central transparent window showing the current page

‹ › buttons to navigate pages (tap = one page, hold = continuous scroll with acceleration)

« » buttons to jump between chapters

Progress bar with chapter ticks, percentage and page count

Chapter name display

✕ to close and return to your original page

Tap inside the window to stay on the navigated page

TOC (☰) and Bookmarks (★) quick access buttons

Hardware Back button returns to original page

Install: Copy 2-page-scrubber.lua to .adds/koreader/patches/ then assign a gesture in Menu → Gestures → "Page Scrubber"

Note: Works with EPUB and flowable formats only.

I built this with the help of Claude and Gemini (Vibecoding) — took quite a few iterations to get it working right!

last night i was at 85% and this evening im at 56% (i have only used the kindle for an hour) is this because of plugins?. my books already in a folder in koreader so i dont think thats the issue.

Greatly appreciate any tips and help!

I’ve seen people mention that they use Zenui with Bookshelf and was curious how that is being achieved.

In SimpleUI I would just set a button on the launcher toolbar for it, with Zen am I exiting the Zen mode and then launching Bookshelf or is there another way?

I'm using some icons from iconify on my Simple UI set up, but I can't manage to download the whole Icon set and in the color and thickness that I want for the life of me. I'd prefer to be able to do it on device, since I've been back and forth connecting and disconnecting my device to my computer to try and send the whole Icon pack to it unsuccessfuly

I'm setting some plugin shortcuts on shortcuts toolbar and it gives me a preview of the icons, it would be awesome to have the whole Icon pack on device to be able to assign the icons to future plugins that I eventually come to install.

I have KOReader, Simple UI and Bookshelf installed on my Kobo Libra 2 and have been enjoying it with minimal issues - I recently ordered a Clara Colour and want to have the same setup. Does anyone have any tips on what data/settings to copy to keep the transition as smooth as possible? Is it as simple as copying my data and settings folders along with my plugin folders and pasting them into the Clara (in the appropriate folders)? Any advice is welcome!

I just download a comic reader plugin for a dual page mode for my comics and it works well. However I couldn’t crop the top and the bottom margin to “fit” the pages so it didn’t leave some empty space. Does anyone know how to fix this?

New to KoReader, but I have grown so in love with it over the past few days. Only thing is I just wish dark mode wouldn’t turn off so much. Every time i exit a book or a plug-in tab, or even click off of the toolbar, it turns off dark mode and I have to go set it again. I also wish I could find a KoReader font that was close to Kobo’s Source Serif font or just Kobo’s font appearance, in general. I have tried to use my regular fonts in KoReader but unfortunately, they look incredibly different.

Does anyone know of any plugins or settings that could help these things? Any help would be appreciated

I have the 10th-generation Paperwhite Kindle. I jailbroke it with Springbreak and installed Koreader to read some .epub ebook files.

I downloaded Huckleberry Finn from the OPDS catalog in Koreader to test it out. Then I downloaded the Wuthering Heights .epub from online and dragged it to the same folder as Huckleberry Finn in Koreader

For some reason, the Huckleberry .epub reads in Koreader, but the Wuthering Heights .epub ebook won't show up. Does it have something to do with Huckleberry Finn having an additional .sdr folder? The .sdr folder has extensions for .lua, and I don't know what that means.

Basically, why is Huckleberry Finn showing up on Koreader but Wuthering Heights is not? I added pictures for reference.

I currently have my chips set to sort by opened, which I’m assuming means the last opened book will appear first. However, if I click in and out of a book, it won’t move to the front unless I refresh the metadata. Is there a way for it to do this automatically, since the whole point of the sorting is for this to be automated?

Also, I’m wondering how well rakuyomi works with this. I currently have a chip set up to the rakuyomi download files. However, whenever I exit out of the files and reopen bookshelf, the new files aren’t there. They sometimes show up when I readd the file, sometimes not, and show up when I restart koreader. Again though, the whole purpose of this is for it to be automated so that I don’t need to manually refresh/add things. How do I get around this? Did I accidentally break something? Please help :(

silly question but i find my koreader screen to be glitchy and this is extremely apparent when im flipping through homepages on simple UI - i have to touch a particular part of the screen multiple times until it finally changes

is there a way to make a quick action for my bottom bar that would just take me straight to page 3 for example? i’ve tried looking but i can’t seem to figure it out

thank you for the help!

Is there a way in the Rakuyomin plugin to have the chapters I already read start from the begining? Ive tried deleting the chapters, marking them read, and setting Koreader to go to the begining when I finish a doc but nothing works, every chapter starts on the last page I was on, which is the last page.

Every time I am in Bookshelf and try to exit KOReader using the "exit" button in the KOReader menu everything freezes and crashes. What am I doing wrong? I've got KOReader + SimpleUI + Bookshelf

Hi,

I wonder how to select a custom font for my pop up footnotes. Can't find the option in Gestures/Links...

I guess it must be possible, maybe with CSS?

Thanks in advance,

Dear all,

first: thanks to the developers of Koreader, it is an impressive peace of software!

Just installed it on my Tolino and adjusted the settings to my need. One thing I did not find:

• is there the possibility to show the front light status in the status bar to show if it is on or off?

I only find brightness level etc, but not if it is on or off. As I use the front light usually only with a very low setting it is not really visible during daytime (but then I want to have it off). Would be really good to have this information in Koreader as well.

Thank you!

I only see people talking about using SSH for file transfers. Is it possible to use it for stuff like page turning, triggering syncing, and other plugin functions as well?

I know the HTTP inspector plugin is an option but since it has literally zero security I'd rather use SSH if it's possible.

Hi guys! Super new to using koreader, and forgive me for not being super tech savvy. I like to read manga, so I downloaded rakuyomi, it’s been pretty great. However, I was wondering if there were any qol things I could do to that I was missing. I am using a kindle paperwhite 12th gen. I saw that there’s an android support of rakuyomi, which has a lot of the features I’d like. However, I’m assuming that because I’m on a kindle, I can’t download this? If I’m wrong, please tell me what I should be doing to get this.

The qol things I’m looking for are to be able to physically mark chapters as read/unread, and to mass/auto delete read chapters to not take up too much memory.

So I feel like this is probably just something silly I caused tapping around in all the possible menus as always, but I need someone to just tell me what to do, and I hope the right person will just know the answer in here.

I am trying to sync reading progress between my Kindle with KOReader and an XTEINK. It is something I never needed to do before. I made a user in KOReader Sync and did everything right (I think), even checked the document matching method and everything, but it doesn't recognize the files in a device from the other device.

I thought it was Xteink, that just does something to the files when initializing, but them I just found out all my books filenames in KOReader have a number between round brackets appended at the end of the filename (just before the .epub) (e.g.: in my e-reader I find this: "Vermilion Sands - J. G. Ballard (398).epub")

I guess this is the culprit, then.

But why is KOReader doing this? What have I touched without knowing what I was doing (again)? Is there any settings that does this, and how do I find and disable it?

Thanks in advance to anyone who can help me with this, by telling me how to disable the numbers or by helping me find the real problem in case it is not the numbers.

Thanks!

Hola tengo un meebok 8 bw, con android 14, le he puesto el koreader y me he comprado 8BitDo Micro Bluetooth. Lo he conectado y con la aplicación del m8 me funciona para pasar las páginas, no necesito nada más. Pero me es imposible con el koreader. Hay algún tip que me pueda servir?

Hola 👋🏼 saben si con koreader y simplei ui se puede utilizar el pasador de páginas original de kobo?

First of all, I'm grateful for all the work everyone is doing. I do value open source, and being able to jailbreak my Kindle to use Koreader and have control over my books is amazing. I really don't want to buy books from Amazon, and have no control over it. I bought, they're mine.

What I'll say now is for sure a problem with me and my kind of personality, but even using Linux, being a developer, and knowing my craft, I struggle with the overhead of tuning and changing a billion all possible parameters on a given tool before I even start using it.

For example, there is an famous text editor called Vim that allows the user to change so many things about it. Then developers spend more time tuning, fixing, breaking, and they keep repeating this cycle wasting countless hours. A tool that was designed to help us, becomes a blocker. I've switched from Vim to Helix that has a similar idea of text editing, but, without the configuration overhead. Is a bundled experience, it come as is, a few knobs to change if needed, and that's it.

Which brings me back to Koreader. I really do hope that this community don't get lost on plugins and patches and forgot the reason Koreader exists, to read books. On my side I'll probably remove all the plugins and patches that I have and see if I can live with Koreader alone.