KOReader(koreader.rocks) |
I actually made a mod to try to upgrade Kobo's built-in reader so it's more correct, i.e. more faithful to how KOReader renders text. Sharing it here since it may be interesting for anyone with Kobo e-readers: https://github.com/nicoverbruggen/NickelTypeFix
Murasaki [1] is the most performant and sleek ebook reader you can get for MacOS currently. It's magnificent, but the creator has regionally limited who can get it, unfortunately.
Less surprising but still annoying is how many hoops you need to jump through to get a good reading experience for manga, particularly on macOS. I had to try many options that were either too buggy, too difficult to install correctly, various aggressive paywalls, or straight up don’t function with high quality scans.
Eventually I landed on one(will edit the name in when I have access to my laptop) that functions well but has some memory issues in importing books, possibly a memory leak.
Maybe I’ve just become shit at finding apps in the modern unsearchable age, but it really feels like reading of all types has diminished enough that we are an unserviceable market.
It also searches Wikipedia.
Ultimately I decided to get rid of KOReader because it felt a bit laggy.
I eneded up writing my own software to sync progress from Kobo to a KOReader Sync server[2] which my Readest app also connects to (love that unlike the Kindle, the Kobo is quite an open system). You can even set it up so you can SSH into it[3].
[1] https://github.com/readest/readest [2] https://github.com/koreader/koreader-sync-server [3] https://www.mobileread.com/forums/showthread.php?t=254214
A tale as old as time with OSS software from what I've seen. So far the only exception that I've seen of a FOSS piece of software with great UX is Blender[1]. With UX not being a first-class citizen on Linux, exposure to a solid universal tooling to create great UX also exacerbates things.
I think the issue of bad UX and OSS are comorbid because good UX needs an extremely opinionated mind at the helm and a culture of prioritizing features and saying "No, this is not important" which OSS generally lacks.
A few people are suggesting that KOReader is symptomatic if the issues with open source software. The reality is it targets a particular group of users.
I think this boils down to profit not being the only driving force for these companies, but prestige and a sense of duty and responsibility towards something larger and less immediate.
You're assuming long lasting soy sauce companies have anything to do with software development. Japan produces great video games despite how terrible otherwise the developer environment and culture is there and nearly all of the other software shows it.
> Software was not viewed so much as a product, but more like a service, similar to integration, training, and ongoing support and maintenance. It was usually sold on a time-and-materials basis, and sometimes it was just thrown in for free to sweeten the deal. The real money was in the hardware.
> Software development was considered rather low-skill work. It didn’t pay well and was viewed as a kind of clerical work. The job was simply to write software that was close enough to whatever sales had promised the client while they were out drinking last week.
What? It can’t even maintain a stable 30fps on its own target hardware. That’s not an example is point to for something running “well.”
Software Japan
- Format support: EPUB, CBR/CBZ (comics, graphic novels), PDF
- Dark mode
- Fully programmable gestures and shortcuts
- Automatically syncs with my readeck instance (think readitlater/instapaper) to dowload the articles I save for example here on HN
- Calibre integration over wifi
- RSS/Atom
- Custom dictionaries
If you are into manga, there is an extension for directly downloading them on the device
I'm really happy I made the switch.
- Allowing to highlight text across pages. Used to work in the past but no longer works
- Allowing exit to library from mobi files without a cold reboot of the device. Used to work, no longer works.
- Not deleting contents of my library on an update overnight? (files still on disk, metadata gone, no longer visible on Kindle)
- consistently working dictionary, offline, at least for English texts? (used to mostly work, with recent updates it is broken)
- Not getting worse on every update
- Better keyboard layout, maybe supporting smaller languages
- Not deleting purchased books remotely
- better bookmarks and navigation support. I find Kindle useless for the technical reading and learning materials, as navigation and cross-referencing is slow clunky and useless, I need paper books for that, or a computer.
- Better image display? Also hinders proper use for digesting technical content.
- Text Search?
- EPUB support.
- Customise any/everything. Font size, line spacing, paragraph spacing, margins, header/footer content, the list goes on
- Ability to use things like BookOrbit (or alternatives) to manage your books and sync your progress/stats.
- LLM-integration through plugins like KOAssistant, highlight a word/phrase/passage to get it explained to you. This was invaluable for me when reading through a series from the 1950's about the late 1700's, lots of phrases I'd never heard. Many I could grasp the meaning from context but it was way more fun to hear the "why" behind the phrase. Same with historical events that I am less knowledgeable about than I wish. Let's me stay "in the book" instead of picking up my phone.
- Full control, some people don't care/need this but I love being able to SSH into my Kindle and do whatever I want. I love having my entire book reading experience end-to-end be fully open source and self-hosted.
I did find it hard to get the bezels to be even and it still doesn't always format well depending on the book. I still kind of prefer the default viewer.
I use this plugin in KOReader which lets you download books from Z-Library within KOReader.
https://github.com/ZlibraryKO/zlibrary.koplugin
Another cool thing is you can use custom fonts and dictionaries. I use the OED short version and the Wikipedia one. There's built in ones that it can download but pirated ones like OED you have to upload yourself.
Unfortunately on MacOS it seems you have to use Amazon's app to access the filesystem.
Edit:
They changed it on the newer Kindle which I have.
There's open source alternatives to the send to kindle app.
KOReader comes with SSH, so you can just SSH into it.
Hmmm not really my experience, unless it's a new thing. I am still able to access it via finder. Although I need to exit KoReader first and go back to the stock UI.
I can recommend using a Filebrowser plugin for KOReader, that way you can access the file system over a web interface and upload that way. No cables needed or anything, quite convenient.
Very grateful for this software!
It's nice to have another option though and if the UX improves one day maybe I'll use it as my main reader.
The software itself is magic, kudos to all the developers and community.
Linux desktop. MacOS laptop. Android tablets. Android phones.
Where-ever I am, I can pick up a device and continue reading from where I left off. I have the same config everywhere (it would be nice to be able to distribute that) for gestures and taps. I use the same font everywhere (TeX Gyre Pagella, which is a Palatino clone.)
Customization begets comfort.
This is the guide I used and it's up to date.
Don’t need the library feature to manage books like Books.app, just need a light and reliable reader.
Paired with BookOrbit [0] and using plugins like BookShelf, BookEnds, and KOAssistant I have the best reading setup ever.
The speed of this on my Kindle is _insane_ compared to the stock software. I'm not talking about page turning, that was fine on both, but navigating menus is way faster.
It was a little finicky to configure but once I got a feel for it I didn't have a problem and 15 books read later since I installed it a few months ago and I never touch the settings.
My favorite plugins:
BookShelf: Best UI for viewing my books by author/series/etc IMHO. Much better than the Kindle default UI and much snappier
BookEnds: Configure the header and footer of each page to show what info you care about most. There are community configs you can test out easily and download right on your kindle if you like them
KOAssistant: highlight some text and throw it at an LLM with a provided prompt or your custom one. This was invaluable when reading the Hornblower series which used a lot of older english words/phrasing as well as nautical terms (which I'm completely unfamiliar with). I enjoyed the books way more since I could figure it out inside my kindle instead of constantly having to pick up my phone to look up a phrase.
BookOrbit: It provides a plugin for KOReader that syncs your progress, annotations, etc.
KOReader is table stakes for any e-reader I might consider. If my Kindle died tomorrow I'd have a Kobo or similar on it's way to me within hours. I won't use any reader that doesn't support KOReader after using it for these last few months.
I don't think KOReader handles fixed-size epubs terribly well too, and most of my manga (usually bought on Rakuten Kobo) comes in that format.
For reading English or native language books on non-Android e-readers it's a godsend.
https://jccpalmer.com/posts/setting-up-kobo-sync-with-calibr...
I'm not associate with this person, just know that these instructions worked for me.
31-mar-2025 https://news.ycombinator.com/item?id=43539103 106 comments
10-apr-2024 https://news.ycombinator.com/item?id=39996947 33 comments
And then the UX… great project but could use a systems guy used to jailbreaking installations and a UX designer
Edit: for kobo at least
Worked fine for me.
Also the fact that you can install different plugin on KOreader and customize it in a way you like is fantastic. for example just check:
- https://github.com/doctorhetfield-cmd/simpleui.koplugin - https://github.com/AndyHazz/bookshelf.koplugin
Or with Lua you can develop your own plugin for that. to people who wanted to jailbreak their Kindle I can recommend these two links:
- https://kindlemodding.org/ - https://www.youtube.com/watch?v=Qtk7ERwlIAk
All in all I am supper happy with KOreader and can't imagine to use anything else
Seriously, takes ages to find specific settings for the first few times.
It has super useful features like the semi-auto-cropping which removes margins in PDFs (like papers or books), including unnecessary things like page numbers or similar, so that you can really maximize the size of the core content. It also has a nice chapter overview and other useful things!
Truly one of the best pieces of software I have used so far.
I finally got around to installing it as I got an xteink x3 and wanted to have cross device syncing back to my Grimmory server. Works great with OPDS and KOSync.
Although I miss using the native kobo sync where I could just add a book to my virtual shelf and have it auto sync to my device. OPDS seems very rudimentary in comparison, but it works nonetheless.
I've been slowly spinning up self-hosted services and Calibre was on my TODO. I haven't even heard of Booklore.
I have a problem with epubs though. This need to support every single thing under the sun makes the pipeline exceedingly complex. All you need for a vast majority of fiction is:
- headings
- paras
- emphasis (bold/italic)
- block quotes
Add simple "image" syntax to it to display maps etc from detective stories
Basically a ruthlessly cut down version of markdown.
The mini-readers from Xteink came in at the right time for such experimentation.
I see it supports audiobooks and ebooks. Do you know if there is any way for keeping sync between an audiobook and ebook?
For my Audiobooks I don't use BookOrbit because my setup is:
- Buy on Audible
- Rip DRM off
- Add to Plex
- Use Prologue (iOS only) to listen
And I freaking love that setup so I'm not looking to replace it currently.
Most OSS software favors power users instead of total beginners. And even Blender is not a great exercise in discoverability. You need training to use it.
The stock software in Kobo and kindle can be used within minutes because they don't have a lot of features/options. And it's totally fine if that's what you need. Just like Windows 7's Notepad. But if you need more capabilities, your wish is notepad++/vim level (which does require more learning), which is what koreader is.
OSS software aligns mentally with "tool". It only exists because someone had a problem to solve, and they wanted a tool to solve it. Generally, people should expect to have to learn how to use tools. Then they solve their problem and move on. It takes effort, and the result is mastery which gives you new capabilities.
Consumer software (and especially anything ad supported or social media adjacent, and sadly in many respects, lots of modern SaaS companies) want to be as glitzy and smooth as possible, but they don't actually want you to solve your problem. Instead they'd really prefer that you simply spend as much time looking at their software as possible. So the experience can be quite pleasant, it feels nice, things feel obvious, you get the dopamine hits quick and fast. But after a while you realize you aren't actually all that productive (or even productive at all) when engaging with them. Because the goal of this software isn't to help you solve your problem. The goal is to keep your attention and extract your money. If it happens to solve your problem... sometimes that's fine, sometimes that's actually counter to the primary mission of extracting your time and money.
The reason I use koreader is because it can sync my progress on disparate devices. I have a normal sized kobo and also a phone sized viwoods eink device.
Wouldn't wanna live there permanently. Wouldn't want to have been born Japanese. But my god the products and services are head and shoulders above my baseline expectations; it's simply nicer.
I also understand why it’s not something common outside of Japan. Selling your family name in exchange for (maybe) keeping your business alive is distasteful imo.
Standard Ebooks for high quality public domain books, though they also offer azw.
There are a number of other free ebook sites out there as well.