← Back to context

Comment by benterris

15 hours ago

KOReader (mentioned in the article, an alternative OSS interface you can install on most ereaders) is really a marvellous piece of software. I was not sure about setting it up at first, fearing it would drain battery out of my Kobo and whatnot, but I never had any issue with it. The amount of stuff you can customize to your liking has no limit and I feel I have reached the endgame of reading comfort. If you own an ereader, I highly recommend installing it. I'm happy and grateful people spend time developing and maintaining it without being paid!

I don’t know man. Maybe it’s a great reader for those who really need to customize everything. However, I found it very hard to use. I can never find settings where I’d expect them to be. Is font or margins or hyphenation under the Gear symbol or the Document symbol or the Wrench symbol or the long-press book settings? Is it then under Typography, Display, Style, Text or Miscellaneous?

I had it on my ereader to check it out, but never got around to it. One time on a long flight I had a Gutenberg Project book that wasn’t rendering correctly and thought I’d give KOReader a try. Spent like 10 minutes trying to find how to disable hyphenation. And even if you get to the right menu, there will be a dozen options to scroll through on 1-3 pages. Maybe if I had internet to check where each setting is to set it up, but it’s not very intuitive to configure. I came from Kobo default reader where all the settings I care about are all front and center and you find them in the first place you look all grouped together.

Also, I realize this is a personal preference, I don’t like the “file explorer” view. I prefer a “library” view like Kobo or Kindle defaults to. If that makes sense.

  • > Also, I realize this is a personal preference, I don’t like the “file explorer” view. I prefer a “library” view like Kobo or Kindle defaults to. If that makes sense.

    I'm with you, my reading device is something where I don't want to fiddle or be distracted by settings and options. I just want a stock, opinionated device with good defaults that just works and I have to charge once a month. That's it.

    • agreed, obviously reading a book itself is the simplest way to read a book. but the simplest way to carry around an entire library is technology. so id like to remove the fiddling or needing to interact with said technology as a barrier to me turning off my brain from life to get sucked into a book

      1 reply →

  • > I don’t like the “file explorer” view

    Exact reason why despite having a jailbroken Kindle, I stick to the stock book browser. It's so tough to navigate on an old-gen Kindle with a low refresh rate.

  • One thing I really appreciate about KOReader is that it runs on so many devices. I like its stock experience, and I can have that experience on my Supernote and on my Kobo, and sync progress between the two.

    Over the years I've gone from Kindle to Pocketboot to Boox to Kobo. Sometimes eReaders break, sometimes I hand them down to family members. Whenever I need to buy an eReader, as long as runs KOReader somehow I can pick the device purely based on its hardware instead of worrying about the stock software, compatible formats, etc.

    But you're absolutely right that finding the specific setting you're looking for is an unintuitive process.

  • > I care about

    Feels like you have my problem: "I can not be bother to switch from another app".

    When every one wants their e-reader with custom setup you get that long list of options. Since the beginning of computing I have always wanted a custom UI on apps, i.e. add an icon here that does these three things in the app, or "add this view to that window". Even browsers plugins have a hard time getting it right.

  • Yeah, the UI IMO is very confusing and I'm not sure it has any benefits for me or features over the stock Kobo interface. It also will understandably never support vertical writing too so it loses some more appeal there for me.

  • Exactly my thoughts. But it all changed when i just put the tailscale proxy on kindle and allowed claude to ssh into it. Now i can just configure it remotely and never really need to do anything else except reading on kindle itself.

    • Ohhhh that's not a bad idea at all. I'd read the article and was still largely in the "but why do I care?" space, but hands off management makes a lot of sense.

  • Agreed. KOReader is great in terms of capability but it is really let down by poor UI. I got used to it but it's not great

  • The UI can be confusing at first. Bu take some time to get familiar with it and it can be really nice. The main benefits for me is dealing with poorly formatted epub and sensible viewing of pdf on small screen (kobo libra 2). There’s also OPDS support to connect to my calibre server instance and get book that way.

    There’s no benefits if you get your books from the stores. But if you manage your ebook library yourself, koreader is great.

KOReader + BookOrbit (or Calibe or whatever you like best) is awesome.

KOReader is finicky to configure but once you have it set up its hands down the best experience. I use BookShelf as my main UI and BookEnds to configure the header/footer. I also use KOAssistant which lets you select text and chuck it at an LLM to explain/translate/custom-prompt/etc.

It was so nice when reading the Horatio Hornblower series where the old references or nautical terms were foreign to me. Just select a phrase, hit Explain, and in seconds get an LLM response right there on my kindle. Just like how the dictionary works (though obviously the LLM isn’t running locally).

With BookOrbit tracking my reading/annotations and providing my ebooks I’ve reached my perfect reading setup. Using Claude to configure some ESP32-based e-Ink screens to rotate book quotes I’ve personally highlighted in KOReader is peak self-hosted, super custom just tor me.

I’m so glad my coworker encouraged me to go down this route!

  • > Just select a phrase, hit Explain, and in seconds get an LLM response right there on my kindle.

    but will it explain without giving spoilers?

    • I’m normally selecting snippets small enough that they don’t invite spoilers. I think the plugin gives the book author/title but I don’t know the full prompt (I should look). So far I’ve not hit any spoilers. For all I know the prompt says something about avoiding spoilers.

      I’ve thought for a while about writing something that only gives the model access to the book as far as you are. Maybe some king of RAG but with page numbers associated so you can filter “< $currentPage” and being able to ask questions “who is this again?”, “how are they related to X?”. The “world knowledge” is the main thing I’d have to be wary of. It’s going to know Harry is a wizard before you get to that part in the books (albeit that’s early, just making a point).

      For the Horatio Hornblower series it was mostly older English phrases that had the feel of a “saying” but I couldn’t be sure of the meaning. Getting a response like “in the late 1700’s this phrase was used to mean…” was really cool, better than having to pull out my phone or just guess.

  • woahhhhhh i had no clue about book orbit. i found calibre stuff to be a bit jank at times. This is super cool. gonna toss an instance on my server tonight

    • This [0] may or may not interest you, yes it’s vibe coded but I wanted a way to hook BookOrbit into my Omni-Claude [1] instance.

      [0] https://github.com/joshstrange/bookorbit-mcp

      [1] This isn’t a “thing”, just Claude code on the CLI that has access to my obsidian notes, home assistant, Unifi, bookorbit, etc. My own, very limited “Claw”. “Speaking” home assistant automations into existence is a whole other topic I could on and on about.

What makes it so good for you? I'm very comfortable with installing stuff like this in general, but I've never felt the need to install KOReader since I don't experience any issues with the basic software.

The only thing I'd maybe like is syncing reading progress with TheStoryGraph, but I can't imagine what else I might want.

  • In addition to stuff mentioned by others, things I like:

    - Fully customizable status bars, top and bottom (I like book progress at the top, chapter progress at the bottom, various indicators like remaining time, brightness level...)

    - Custom dictionaries (like reader.dict, very complete), and choice over how to display them

    - Advanced typography stuff (override publisher font if you like, add all the ligatures...)

    - Fully customizable gestures (jump anywhere, recent locations, skim book, bookmark page, adjust brightness...)

    - Book map: see a schematic view of the whole book, with chapters / subchapters length (gives me a feeling of how much I've read and is left to read, as would a real book)

    - Page number / count that "just works" (epubs on kobo don't count actual page flips which I find annoying)

  • I’ve only just installed it this week, but for me:

    - DRM support (via a Plugin)

    - Dark mode on an older device

    - SSH Server

    - Custom dictionaries

    Next on my list is to find a plugin that can transform imperial to metric for when I’m reading American books

    Edit: oh and also something that syncs my progress on books not bought from Amazon on multiple devices

  • Auto dark mode after dusk based on your location

    Better page flip area options

    Active corners that can do custom things and with layers

    More text layout options (although the stock kobo firmware is decent at that already)

    It’s a bit cumbersome to setup but once you’re done it pays back in how pleasant it makes the device to use.

  • It's very configurable and extensible. As some have mentioned, the interface can be a bit confusing at times but once you're used to it it's mostly out of your way. I like that I can run it on both my Kobo and android phone and sync progress. I also self host an opds server but you can also connect to calibre, syncthing, or cloud storage to pull down books. There's even a plugin to sync my progress to hardcover, which is a more open alternative to Goodreads.

  • A few things I like:

    - More frontlight options. Ability to toggle on/off easily using corner taps,

    - More page layout and typography options e.g. custom fonts,

    - Ability to load from Calibre over WiFi (I never plug mine in via USB).

    Worth nothing that KOReader doesn't replace the default Kobo firmware. It's easy to install and you launch it from the Kobo firmware so it's easy to quit and go back to normal.

    • > Worth nothing that KOReader doesn't replace the default Kobo firmware. It's easy to install and you launch it from the Kobo firmware so it's easy to quit and go back to normal.

      Ah, that's definitely something I missed, sounds like a good reason to give it a try!

      2 replies →

  • The overwhelming thing I hear about KOreader is once people use it for their way of reading (including doing things they coudlnt) they can't use an ereader any other way again.

Same on my kobo. The only thing I was missing was the kobo like Home Screen where it shows all your books no matter how deeply nested. But of course there is a plugin for that: https://github.com/AndyHazz/bookshelf.koplugin

The only thing I’m missing now is a stylesheet or something to make a spot on the right edge be free of text as that’s where my external page turner clips (for hands free reading) and it hides part of the book’s text otherwise. If anyone has any clue on how to do it, lmk!

KOReader is a must have for Remarkable 2. If you are going to install it on your Remarkable 2, use reManager.m, it's amazing.

A similarly awesome ebook reader on Android is Librera. The package on F-Droid is the full version but one may also buy it on the play store the support the Ukranian developer.