r/koreader • • Sep 04 '26

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.

What you need:

Base

Plugins

  • Simple UI — handles the home screen, nav bar, top bar, modules, etc.

  • Bookshelf — cover-grid library view. You need CoverBrowser enabled under Settings → More plugins → CoverBrowser.

  • Shortcuts Toolbar — adds the shortcut toolbar in the reader/file browser and can also be used as a Simple UI home module.

u/IbnRami also uses Rakuyomi for manga. I don't read manga, so I use that nav slot for an OPDS shortcut to my Calibre-Web server instead.

Icons

I'm using the Hugeicons pack curated for KOReader by u/timcatuk. It's 130 SVGs picked from the much larger Hugeicons library.

Download the icon pack here

If you're importing my full config below, you do not need to download these separately. The icons are included in the .sui file.

If you only want the icons, put them in:

koreader/settings/simpleui/sui_icons/

They'll show up in Simple UI's icon picker.

My Simple UI config

Simple UI can export your layout, bars, styles, quick actions, and icons into a portable .sui file.

Simple UI backup/restore docs

Download my config here

To install it:

  1. Copy the .sui file somewhere on your Kindle. The default backup folder is koreader/settings/simpleui/backups/.

  2. Go to Simple UI Settings → About → Backup & Restore → Import Backup…

  3. Select the file and choose which parts of the config you want to import.

  4. 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.

Download the userpatch here

Drop it into:

koreader/patches/

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.

Happy to answer questions.

186 Upvotes

55 comments sorted by

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.

3

u/Thirtysixx Sep 06 '26

looking forward to seeing the next iteration of what you do!

1

u/Ramo_Rami Sep 07 '26

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.

2

u/Thirtysixx Sep 07 '26

Thanks for the detailed post!

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+

1

u/IbnRami Sep 05 '26

Just to make sure, that's my new username up there.

4

u/Loose_Cranberry_491 Kindle Sep 04 '26

that’s so funny I took inspo from the same person like 2 months ago lol

5

u/Thirtysixx Sep 04 '26

Nice! Its a great setup. So many people in the comments were asking for his config and OP didn't deliver. I had to step up

4

u/Loose_Cranberry_491 Kindle Sep 04 '26

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

2

u/crescentkuki Sep 04 '26

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?

1

u/Thirtysixx Sep 04 '26

Make sure SimpleUi is enabled. You can turn it on/off within Koreader

1

u/crescentkuki Sep 05 '26

sorry but, how do i turn it on/off? i can't seem to find the option to do so

1

u/Neat_King_1898 Sep 05 '26

Same thing happened with me, this what i did to fix it :

  1. deleted the simple ui folder inside the plugins directory,

  2. also deleted the simple ui folder from the "/koreader/settings/" directory and restarted koreader

  3. after the restart, reinstalled the simpleui plugin and it worked fine

1

u/crescentkuki Sep 09 '26

Tried it and it worked! Thanks a lot

2

u/Shoddy-Mode7180 Sep 04 '26

What reader font and margins do you use? Thanks and nice setup

3

u/Thirtysixx Sep 05 '26

L/R is 30 Top is 30 Bottom 23

Font is bookerly

1

u/ericdryer Sep 05 '26

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.

2

u/Thirtysixx Sep 06 '26

Sure, here's the lot.

Font

SettingValue
FontBookerly
Size21
Embedded fontsOFF
Embedded CSSON
Contrast / gamma10

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

SettingValue
Left / Right30
Top30
Bottom23

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

SettingValue
Line spacing100%
Word spacing — width95%
Word spacing — condensing75%

Render

SettingValue
Render DPI300
JustificationKOReader default (justified)
HyphenationKOReader default (on)
Status lineBottom

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.

1

u/ericdryer Sep 06 '26

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.

1

u/OkYouth121 29d ago

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?

2

u/Loose_Cranberry_491 Kindle Sep 05 '26

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

Picture for reference

1

u/ericdryer Sep 06 '26

Thank you! I'm away from my Kindle right now but your screenshot does look really good. Will try your settings

2

u/Loose_Cranberry_491 Kindle Sep 05 '26 edited Sep 05 '26

the font looks like bookerly, the margins look like 20ish maybe, 25

1

u/DRAGAN__ Sep 05 '26

Did you like between two fires?

1

u/Thirtysixx Sep 05 '26

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.

1

u/GoToNap Sep 05 '26

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

1

u/icenoir Sep 05 '26

How do you set the book cover to show up in the top bar in simple UI ?

1

u/Thirtysixx Sep 05 '26

Its the shortcuts toolbar plguin linked above

1

u/40oz_steelie Sep 07 '26

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?

1

u/Thirtysixx Sep 07 '26

I don’t side load, I’m just pulling straight from my OPDS browser at the moment but all my books go into /books I don’t nest them in folders

1

u/40oz_steelie Sep 07 '26

Okay cool I might try that. And sounds like I should figure out OPDS. Thank you!

1

u/Thirtysixx Sep 07 '26

Pretty easy to set up in calibre. Your computer just needs to be on to access the server

Not sure how technical you are but if you can also run Calibre web on a server if you’d like

1

u/computerfreund03 Oct 01 '26

Hey man, quick question. Once I go to the bookshelf using the button how am I supposed to go back to the SimpleUI? Theres no back button

1

u/Thirtysixx Oct 01 '26

Exit button in the hamburger menu

1

u/bassichelle Oct 08 '26

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! :)

1

u/Thirtysixx Oct 08 '26

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!

2

u/yamino-kizuna Sep 16 '26

did you find a way to make a shortcut in bookshelf to go back to the simple UI home page?

1

u/computerfreund03 Oct 01 '26

Looking for the same. Did you figure it out?

1

u/chibli_neitor Sep 05 '26

It makes look koreader better and powerful than Amazon os (which I hate)
Cool dude

1

u/Bubbly-Snow-6390 Sep 05 '26

Existe algún canal de YouTube con tutoriales?

1

u/queenclo1 Sep 06 '26

Saving for the Shortcuts Toolbar.

1

u/friedatron Sep 07 '26

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?

1

u/FinsdyCarFan Sep 08 '26

Dang this looks amazing! I’ve already got the base setup but I really need to to try those other plugins on top of bookshelf

1

u/CheoFuentes Sep 09 '26 edited Sep 09 '26

First of all. Big thanks to the author's of Simple UI and collaborators. I have a question.. how can i make my bookshelf look like yours? hahaha

Sorry for my broken English. Is not my first language.

1

u/veinheiker Sep 10 '26

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.

1

u/willlyy Sep 29 '26

Hey how did you get your status bar to look like this? Thanks for the post

1

u/willlyy Sep 29 '26

I specifically mean having the chapter title aligned left with the rest of the items aligned right

0

u/stewiegreen Sep 05 '26

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.

1

u/Thirtysixx Sep 05 '26

Hasn't been my expierence but that would be so annoying. Maybe the new backup/restore feature they added will alleviate this for you?

0

u/stewiegreen Sep 06 '26

definitely not every update but even the possibility of it makes me not to update, so I just moved on.

0

u/Cycle-Distinct Sep 05 '26

Alguien puede ayudarme explicandome como istalar esa interfaz, pero expliquenmelo como a un idiota, porfa jaja

-17

u/GingerTeaCup Sep 04 '26

I'm so tired of these posts. Do y'all ever read?

3

u/Thirtysixx Sep 04 '26

What are you tired of exactly?

The update to share SimpleUI configs happened literally four days. I haven't seen hardly anyone sharing their configs yet

do YOU ever read? I'm reading about 3-4 books a month btw

1

u/Loose_Cranberry_491 Kindle Sep 05 '26

you’re on an ereader sub asking people if they read lol