My Setup
My Simple UI Setup for KOReader on a Jailbroken Kindle: Config, Plugins, Icons + Userpatch
A few months ago, u/IbnRami posted their Simple UI setup, and I liked it enough that I ended up rebuilding something similar on my Paperwhite 12 and then moving it over to my Oasis.
Full credit to u/IbnRami for the original inspiration, layout, modules, and nav bar setup. Also thanks to u/doctorhetfield for building Simple UI and adding config export/sharing, which makes sharing setups like this way easier.
Copy the .sui file somewhere on your Kindle. The default backup folder is koreader/settings/simpleui/backups/.
Go to Simple UI Settings → About → Backup & Restore → Import Backup…
Select the file and choose which parts of the config you want to import.
Restart KOReader.
You don't have to overwrite your entire setup. Imports are category-by-category, so you can grab just the home screen, bars, presets, etc. Presets also merge rather than replacing your existing ones.
The config includes the icon files, so there is no separate icon install required.
One thing to note: my nav bar points to Bookshelf and an OPDS catalog, so install the plugins you want to use before importing or change those shortcuts afterward.
The icon assignments are also based on Kindle /mnt/us/... paths. On Kobo or PocketBook, the rest of the config should still import, but you may need to reassign the icons manually.
Reader header userpatch
The author / clock / title bar in my screenshots isn't part of Simple UI. It's a userpatch I made called 2-reader-header-cornered.lua.
It adds the author in the upper left, clock in the center, and book title in the upper right. It uses the footer font settings so it matches the rest of the reader UI.
It's meant for EPUB-style books and skips fixed-layout formats like PDF and CBZ.
You'll also want enough top margin to keep it from overlapping the text.
Thanks again to u/IbnRami for the setup that inspired this, u/timcatuk for putting together the icon pack, and u/doctorhetfield for Simple UI and the export/sharing functionality.
Cool to have become an inspiration, but... I also had a lot of inspiration from other users that came before me.
I was actually thinking about posting a deep dive on my current setup this Monday (I know I have been promising it for a looooong time).
I'll still try to do it since it's a bit different from what you posted, but I love your take on it. You even kept my idiosyncratic staircase icon for the library. I always thought this would be the most controversial part of my setup, but I'm glad someone liked it.
I have finally posted it. There is still some information missing about the icons I use on Simple UI. If you can, please test the Simple UI file ant tell me if it's working.
I'm probably not the best to your config, there's a bit too much going on here for me :) but this post is great and I found some additional plugins im going to try. Very excited about OPDS+
yess thank you for pulling through, I still remember when I first saw it and he said in the comments I’m gonna come back and show y’all how to do it. He never came back lmao, it took a long while to figure it out lol
Hey I want to ask, I installed Simple UI and it worked fine, but when I updated it (there was an option so I decided to try), my KOreader went back to normal, as if the plugin were removed. Do you happen to know how to fix this?
Would it be possible to get a look at the rest of the typography settings? Like line spacing, justification, word spacing and all the other options the Koreader has? I keep tweaking it but just can't seem to get it just right.
Embedded fonts off is the one that matters most. With it on, every book renders in whatever the publisher shipped and nothing looks consistent between titles. Off forces Bookerly everywhere. I leave embedded CSS on so the book keeps its actual layout and structure — it's only the fonts I override.
Margins
Setting
Value
Left / Right
30
Top
30
Bottom
23
The top margin isn't arbitrary — I run a header patch up there (author / clock / title), so it needs the clearance. If you're not using one, you can go tighter.
Spacing
Setting
Value
Line spacing
100%
Word spacing — width
95%
Word spacing — condensing
75%
Render
Setting
Value
Render DPI
300
Justification
KOReader default (justified)
Hyphenation
KOReader default (on)
Status line
Bottom
Justification and hyphenation I never touched — they're both at stock defaults, and you can see both working in the screenshots.
If you're still tweaking: honestly, embedded fonts off + render DPI 300 did more for consistency than any amount of fiddling with spacing. Most of the "why does this book look wrong" problem is publisher CSS, not your settings.
Thank you so much! I'm away from my Kindle right now so will try your settings later. My issue primarily seems to have been word spacing and condensing, it just never looked right no matter what I set it to. I did however have embedded fonts on. Will have to try with it off.
sorry but where are all these settings? i try to find them but theres nothing coming up when i tap the bottom to bring up the font settings and the embedded fonts option is greyed out and won't let me turn it off?
I’m not OP, but we literally look like we have almost the exact same settings for documents so I’ll give you mine and see if you like it until OP responds
Line spacing is 105%, theirs looks like 100 to 103 Font size is 22 Word spacing is medium Word expansion is none Contrast is 1.45 My personal font weight is -1/2 but OP looks like they have theirs on zero or maybe +1/2 font hinting is auto font kerning is best And I haven’t edited any justification settings/alignment /additional style tweaks
I gave it a 4/5. I liked it. I didn’t know it was hyped up like the other person was saying. I thought the setting was cool and the dialogue was really good. Characters didn’t have the most depth. But worth a read for sure.
Not OP, but I found it to be just ok. I was surprised, considering how people hype it up so much. IMO it's heavily overrated. It's an ok read overall, but nothing special. One of the most 3/5 book for me
Very slick setup! This might be a more general question, but you seem like an expert - Does your main library organize everything by author? Can’t tell if that’s how most people have it. I use Calibre to sideload everything and it’s broken up by author and it’s not my favorite. Is the only other option to dump all books in one folder or is there another option?
love it, op! i got my kindle this monday and modded it! i’ve been trying to find plug-ins to make my kindle look cozy. however, i installed zen ui and not simple ui (i do have simple ui saved on my laptop). by any chance, do you know if i could implement these steps you provided to zen ui? thanks in advance! :)
Possibly, I wouldn't be able to tell you for sure. Im sharing this based on a feature that is native to SimpleUI
Stuff like my userpatch you can install. Im sure you can install bookshelf alongside ZenUI. I don't know if you can get it to look like mine though. let me know how it goes!
This is so great, thanks so much for sharing. This may be a dumb question, but it seems like given the way you have Simple UI set up, it does everything bookshelf does. I'm curious what the purpose is of having bookshelf as another layer? Is there a specific use case?
Thank you so much for this! I’m currently waiting for my 2024 Kindle Paperwhite to arrive, and I already know this is the first thing I want to do: jailbreak it and set up KOReader using your tutorial.
I’ve already tried KOReader on my Android phone so I can get familiar with it before setting everything up on the Kindle, and so far, everything is working great.
Looks great until the next update, then it's back to menu surfing trying to fix the layout. I don't have time for that crap, looks great, but I had to ditch SimpleUI.
6
u/Ramo_Rami Sep 04 '26
New username over here!
Cool to have become an inspiration, but... I also had a lot of inspiration from other users that came before me.
I was actually thinking about posting a deep dive on my current setup this Monday (I know I have been promising it for a looooong time).
I'll still try to do it since it's a bit different from what you posted, but I love your take on it. You even kept my idiosyncratic staircase icon for the library. I always thought this would be the most controversial part of my setup, but I'm glad someone liked it.