KOReader, made to read like the Kompakt's own apps

KOReader is the best reader there is for an E Ink phone, but it was drawn for Kindles and Kobos. On the Kompakt its menus come out in small grey type, with tight rows and small icons that are hard to read and hard to hit.

This is one small file that changes that. KOReader runs any file it finds in its own koreader/patches/ folder when it starts, and this is one of those, so KOReader itself is untouched and keeps updating as usual.

The reading menu, as it is and with the patch

What it changes:

  • the interface in Lato, the typeface of the Kompakt’s own apps
  • all interface type a size larger: menus, lists, dialogs, the status bar and the settings panel
  • larger icons in the menu bars and the settings panel
  • taller menu rows and dialog buttons, so a thumb finds one
  • lines and switches in black instead of grey, which on this screen is dithered into a faint speckle
  • dialogs with a firmer edge, and file sizes in Lato rather than a typewriter font

The text of your books is not touched; that stays whatever you set in the book. Nothing is written into KOReader’s settings, so deleting the file puts everything back exactly as it was.

A dialog, as it is and with the patch

To install, download koreader-kompakt.zip from the release page below. Copy the patches and fonts folders inside it into the koreader folder at the top of the phone’s storage, then close and reopen KOReader.

Release: Release v0.1.0 · wanderwildwood/koreader-kompakt · GitHub
Source and install notes: GitHub - wanderwildwood/koreader-kompakt: KOReader on the Mudita Kompakt, made to read like the phone's own apps: one user patch, Lato, larger type and icons, black lines. · GitHub

If a screen in KOReader still feels like it belongs on a Kindle rather than the Kompakt, tell me which one.

10 Likes

You really are the king of fixing problems I didn’t even think to ask anyone to fix.

4 Likes

I use Readest at the time. As i see this i think i will try KoReader with your fix. Thank you.

2 Likes

Honestly, I was waiting for you to make an E-Reader app, so this is amazing, as I am already using KOReader.

An issue that I am facing since installing your patch is that longer titles are overlapping the lines (or is there even a way to have a better looking first screen?)

And a second issue I am having with KOReader (dont know if you can do something about that) is that I prefer the landscape mode for reading but I always have to set it anew when I start the app. I marked that the rotation should be saved, there is a little star on it and I ended the app properly but after some time (not every new start) it jumps back to horizontal orientation. Is there any fix for this?

2 Likes

:revolving_hearts::revolving_hearts:::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts::revolving_hearts:

2 Likes

@hanswilli Thank you, and for the screenshot, it showed exactly what went wrong. 0.1.1 is up: the lists with covers now keep KOReader’s own type size, so the patch no longer pushes titles over the row below. Replace patches/2-kompakt-look.lua with the one in the new zip and restart KOReader: Release v0.1.1 · wanderwildwood/koreader-kompakt · GitHub

Your list also has “Shrink item font size to fit more text” turned off. With it off, KOReader still lets a two-line title run into the next row, patch or no patch. It is in the file browser’s menu under Settings → Mosaic and detailed list settings; with it on, each title steps down until it fits. Fewer files per page, in the same place, gives every row more room.

The rotation is KOReader’s own, and not something the patch reaches. The star sets the default for books opened from then on, but a book you have read before can keep the rotation it was last read in, and the file browser has a rotation of its own as well. If it still flips back after that, the KOReader developers on GitHub would want to hear about it.

2 Likes

I tried this, copied the files into the top Koreader folder on internal storage, but nothing changed.

2 Likes

@YYZ Thanks for trying it. Nothing changing at all, not even the typeface, means KOReader isn’t finding the patch. The zip has its own koreader folder, so the usual slip is ending up with koreader/koreader/patches/…. The file needs to be at koreader/patches/2-kompakt-look.lua, with the two Lato fonts in koreader/fonts/, beside the folders KOReader already has.

Then close KOReader from its own menu (Exit) rather than just swiping it away, and open it again. If it still looks the same, tell me where the file is and which KOReader version you have.

2 Likes

The files are in the correct folders/locations. My KOReader version is the latest one 2026.07.1

2 Likes

@YYZ Thanks, that rules out the folders. KompaktOS shouldn’t matter; it’s the same Android underneath, and I test on the same KOReader version you have. One thing does: the F-Droid build of KOReader skips user patches entirely, by design. If yours came from F-Droid (or a store that uses it), that’s why nothing changes. The build from KOReader’s GitHub releases (the arm64 APK) runs them. It needs the F-Droid one uninstalled first, but your books, settings and history live in the koreader folder and stay put.

To check: in the file browser, Tools → More tools → Patch management lists the patches it found and how many ran. Also make sure “Disable external plugins and user-patches” isn’t ticked.

2 Likes

Yes indeed I downloaded it from F-Droid. That’s it then. Thanks for the info.

1 Like

Thank you! I added this and then changed DPI setting to larger font. Classic mode for display and added a patch for removing the file size and file name .epub

Looks like this afterwards:

2 Likes

@somastudy Thank you for sharing this. A library that reads like a bookshelf is a good idea, and your screenshot shows it well.

It’s now part of the patch as an option, off until you tick it: File browser → Settings → Classic mode settings → Hide file size and extension. Books then show by title alone, and folders keep their counts.

It’s in v0.1.2: replace koreader/patches/2-kompakt-look.lua with the one in the zip and restart KOReader. You can drop your own patch for this once it’s on. The cover lists already show titles without extensions, and have their own “Show file properties” switch.

2 Likes

I’m new to KOreader, where can I find File Browser?

1 Like

@TechVampire The file browser is KOReader’s library, the list of your folders and books. It’s what you see when KOReader starts without a book open.

If a book is open:

  • Tap near the top of the page to show the menu.
  • Press the folder icon at the top left. That takes you to the file browser.

In the file browser, tap the top edge again for its own menu. The first tab (the folder icon) has:

  • Display mode: choose Classic for a plain list.
  • Settings → Classic mode settings: this is where Hide file size and extension lives once the patch is installed.

In the cover views, titles already show without the extension.

1 Like

Your explanation was wonderful and I was able to find the setting and switch it on, but it doesn’t seem to be doing anything, even after restarting KOreader a couple of times. I do use the Github version.

2 Likes

@TechVampire Thanks for the screenshots, they show exactly what’s going on. Your library is in the Detailed list view, the one with the covers and authors. For now the switch only works in the plain Classic list, which is my oversight: the detailed view draws its “epub 2.6 MB” line from its own code.

Two ways round it:

  • Today: in the same first-tab menu, set Display mode to Classic, and the sizes and endings go.
  • Coming: I’m updating the patch so the switch also works in the Detailed list, keeping your covers and authors. I’ll post here when it’s out.
2 Likes

Thank you for your patience and help, as always!

2 Likes

@TechVampire Fixed in v0.1.3. In your Detailed list view the switch now hides the file type and size (“epub 2.6 MB”), while the reading progress and the “new” mark stay. It also holds after a restart, which was a second bug your screenshots helped find.

To update, replace koreader/patches/2-kompakt-look.lua with the one in the new zip and restart KOReader. The switch now also sits under File browser → Settings → Mosaic and detailed list settings, beside “Show file properties”. The two are tied together, so they always agree.

3 Likes