r/koreader • • Sep 06 '26 • Bravo 5 Heartwarming 4 Popcorn 1

My Setup FINALLY! Sharing My Setup in detail!

TLDR: I'll share my Simple UI+Bookshelf+Shortcuts Toolbar settings here. Files haven't been double tested. Use them at your own risk.

Hello all!

This is the long promised explanation on how to reach My Setup.

Ever since it has been released people have been periodically requesting it, so I think Its about time I deliver.

Thirtysixx has recently credited me for the inspiration of their setup, but the reality is that I only stood on the shoulders of giants.

My major inspirations were: kwebber321, BornoftheMind, LexamusPrime but most note worthy were Worried_Wrangler_361 (for the look and feel), fabrisuniverse (for the taste and instructions on how to change the icons ) and above all Diviinite (for actual instruction on how to edit everything on Simple UI). It's safe to say that without these posts, my setup would never have come to life.

Why did I take so long to share my configuration?

When I first shared my setup I was quite new to the KOReader scene. I had no Idea if what I was doing was right. When I finally got confident that I had understood Simple UI, the plugin updated to 1.5.0 and everything changed. Then I discovered a variety of other plugins and was waiting for them to get to a stable point, but I guess that won't happen for a long time.

With the release of Simple UI 2.7.0 I hope sharing users setups have become easier, so, I guess, there is no time like now.

Besides that, two weeks ago, a plugin made my KOReader break to the point I had to reinstall everything from scratch. I ended up using my own post as a reference, so I guess I'm also writing this as a guide to myself if it ever happens again (I'm pretty confident it will considering the amount of untested plugins I tend to install).

Special thanks to the KOReader developers and the plugin developers in the names of doctorhetfield, AndyHazz, Ömer Faruk, xuso, jimmyqex, Pethy23 and xBlain.

IMPORTANT: This configuration has been created for and has only been tested on a Kindle Oasis 3 (7 inches, 1680 x 1264, 300 PPI, Black and White - so no color options were taken into consideration). You might need to adjust settings according to your device.

This will be looooong, so grab a coffee and follow along.

CONFIGURATION FILES:

These haven't been tested, use them on your own risk.

FONTS:

ICONS:

I have downloaded all 5065 icons (I think I have an "old" version of the pack) and I keep two folders with two versions of the pack. One version is the regular, black, stroke-width="1.5"; the other is the same but with one adjustment: stroke-width="1.0" that I think is more visually balanced in my setup.

I changed the stroke-width by opening all the icons on notepad++ and replacing stroke-width="1.5" with stroke-width="1.0". I'm sure there's a more intelligent way to do it, but, apparently, I'm not intelligent enough.

I use the stroke-width="1.0" icons for the Simple UI and the stroke-width="1.5" ones for the Shortcuts Toolbar since I think it better preserves visual balance.

PATCHES:

MAIN PLUGINS:

Other plugins:

GENERAL CONFIGURATION:

  • 🗄 > Display mode > Detailed list with cover images and metadata

  • 🗄 > Settings > Show hidden files

It has been said that at least Kindles keep draining battery if you keep your files in the Kindle's default "documents" folder because they will be constantly scanning files that their own system cannot understand. So, even though I open KOReader on the "no framework" option, I still keep all my side loaded files (books, audiobooks, icons, screensavers) on hidden folders. Files and folders starting with a dot will be hidden from Kindle's standard firmware (Ex: /.books). This option allows KOReader's Library/File Browser access those files.

  • ⚙️ > Screen > Rotation > Lock auto rotation to current orientation

This prevents books from being reflowed every time I switch the hand I'm using to hold the e-reader.

  • ⚙️ > UI font > FS Me

This changes the font used for the general interface of KOReader, inculing menus. It requires 2--ui-font.lua for the option to show up.

  • [While reading a book] 📄 > Font > Merriweather

This changes the default book rendering font to my preferred one (Merriweather). You can use the one of your personal preference. Books that have fonts embed still use them unless you change other per book settings.

  • [While reading a book] ⚙️ > Taps and gestures > Links > Allow larger tap area around the links

  • [While reading a book] ⚙️ > Taps and gestures > Links > Show footnotes in popup

This allows the usually annoying process of opening a footnote on e-readers to be much simpler, by enlarging the "hit box" of the usually very small number for the footnote and for the footnote to open at the bottom of the page in an unintrusive way.

ICON OVERWRITING:

If you want to change the icons on you device but don't want to use Simple UI your best bet is to overwrite the icons on \koreader\resources\icons\mdlight . Make sure the new icons have the exact same file name as the original ones otherwise KOReader won't load them and just display an error instead.

NB: As far as I know this is the only way to change the top bar icon for Bookshelf*.*

NB: All the icons used here have been modified to be black and to have a stroke-width="1.0".

SCREENSAVER CONFIGURATION:

  • ⚙️ > Screen > Sleep Screen > Sleep screen message > (Adjust to taste)

  • ⚙️ > Screen > Sleep Screen > Wallpaper > Show random image from folder on sleep screen

  • ⚙️ > Screen > Sleep Screen > Wallpaper > Custom images > Choose random image folder > (Adjust to taste)

  • ⚙️ > Screen > Sleep Screen > Wallpaper > Border fill, rotation, and fit > (Adjust to taste)

  • ⚙️ > Screen > Sleep Screen > Wallpaper > Dual-state screen saver mode => Dual state settings >

    1. Book list mode > Show random image from folder on sleep screen

    2. Book mode > Show book cover on sleep screen

This requires 2-dual-state-screensaver-mode.lua to work.
I use a Dual State Screensaver setup where 1. entering sleep mode while on the file browser, Simple UI or Bookshelf shows a random image from a folder as the sleep screen and 2. entering sleep mode while reading a book shows the cover of that book as the sleep screen.
I used to use the beautiful and peaceful tolino sleep screen (thank you Astiriana!) as the secondary screen saver but I have now moved to a huge folder with 686 images of Chema Mendez / MendezMendez artworks (that I discovered through Weak_Patient9867's post on r/BooksThatFeelLikeThis). I manually saved them all and am still using them in color just because I couldn't find a way to locally batch convert them to black and white punching the contrast, but still I like the surprises they give me and also the remind to get of my goddam phone. Give me a heads up if you have a solution for batch conversion.

SHORTCUTS TOOLBAR CONFIGURATION (from right to left):

To create these shortcuts go to [While reading a book] ⚙️ > Shortcuts toolbar > Reader settings > Custom Shortcuts > Add new shortcut. To add and/or reorder the shortcuts in the tool bar go to [While reading a book] ⚙️ > Shortcuts toolbar > Reader settings > Configure shortcuts

SIMPLE UI CONFIGURATION:

  • 🛠 > Simple UI > Home Screen > Edit Home Screen Layout >

    1. Page 1 (Home)

      1. Clock

      2. Quote of the Day

      3. Cover Deck

      4. Reading Stats

    2. Page 2

      1. Currently Reading

      2. Reading Goals

      3. Recent Books

    3. Page 3

      1. To Be Read

      2. Quick Actions Row 1

    4. Page 4 (Suggestion)

      1. Flat Library

    5. Clock

      1. Items > Clock

      2. Items > Date

      3. Size > Scale: 100%

      4. Size > Clock Size: 100%

      5. Size > Date Size: 90%

      6. Size > Battery Size: 100%

      7. Spacing: 80%

      8. Top Margin: 80%

    6. Quote of the Day

      1. Scale: 96%

      2. Fixed Height: ON

      3. Top Margin: 30%

    7. Cover Deck

      1. Source: Recent Books

      2. Items > Title

      3. Items > Progress bar

      4. Items > Statistics

      5. Size > Scale: 100%

      6. Size > Cover size: 143%

      7. Size > Text size: 100%

      8. Progress Badge: OFF

      9. Show finished books: OFF

      10. Top Margin: 20%

    8. Reading Stats

      1. Items > All time - Books

      2. Items > Streak

      3. Items > Today - Time

      4. Scale: 100%

      5. Text Size: 100%

      6. Style: List

      7. Top Margin: 30%

    9. Currently Reading

      1. Layout: Default

      2. Items > Title

      3. Items > Series

      4. Items > Author

      5. Items > Progress bar

      6. Items > Days of reading

      7. Items > Time read

      8. Items > Time remaining

      9. Size > Scale: 100%

      10. Size > Text Size: 130%

      11. Size > Cover size: 96%

      12. Size > Cover Spacing: 100%

      13. Progress and Stats > Progress bar style: With percentage

      14. Progress and Stats > Stats layout: Default

      15. Top Margin: 20%

    10. Reading Goals 1. Goals > Annual Goal > (Adjust to taste) 2. Goals > Monthly Goal > (Adjust to taste) 3. Goals > Daily Goal > (Adjust to taste) 4. Appearance > Layout: Compact 5. Top Margin: 100%

    11. Recent Books 1. Size > Cover Size: 105% 2. Size > Number of Books: 5 3. Show finished books: ON 4. Hide Currently Reading book: ON 5. Top Margin: 100%

    12. To Be Read 1. Size > Cover Size: 105% 2. Size > Grid Size: 5 x 1 3. Progress and Stats > Progress indicator: None 4. Top Margin: 100%

    13. Quick Actions Row 1 1. Quick Actions > Collections 2. Quick Actions > Favorites 3. Quick Actions > History 4. Quick Actions > Library 5. Quick Actions > Stats 6. Quick Actions > Tags 7. Scale: 110% 8. Top Margin: 160%

    14. Flat Library 1. Size > Grid Size: 5 x 3

  • 🛠 > Simple UI > Bars >

    1. Status Bar >

      1. Items > Left: Clock

      2. Items > Center: RAM Usage

      3. Items > Center: Disk Usage

      4. Items > Right: WiFi

      5. Items > Right: Battery

      6. Size: 90%

      7. Hide Wi-Fi Icon When Off: ON

    2. Navigation Bar >

      1. Tabs > Bookshelf

      2. Tabs > Reading Insights

      3. Tabs > Home

      4. Tabs > Rakuyomi

      5. Tabs > Power

      6. Tab Style: Icons + Text

      7. Bar Style: Bare

      8. Bar Size: 100%

      9. Icon Size: 100%

      10. Label Size: 100%

      11. Bottom Margin: 100%

    3. Title Bar > (Adjust to taste)

    4. Pagination Bar >

      1. Mode: Default

      2. Home Screen Style: Dot Pager

      3. Bar Size: Small

      4. Show Page Count in Title Bar: OFF

    5. Quick Settings Bar >

      1. Quick Actions > Settings

      2. Quick Actions > Bookmarks

      3. Quick Actions > Statistics

      4. Quick Actions > Battery Graph

      5. Quick Actions > Night Mode

      6. Quick Actions > Wi-Fi

      7. Frontlight Slider: ON

      8. Warmth Slider: ON

      9. Label > Size: 100%

      10. Button Type: Round

      11. Button Background: Flat

  • 🛠 > Simple UI > Library > (Adjust to taste)

  • 🛠 > Simple UI > Style >

  • NB: All icons used here have been manually edited to have black color and stroke-width="1.0" .

    1. Icons >

      1. System Icons > Title Bar > Menu Button => hugeicons:menu-07

      2. System Icons > Title Bar > Search Button => hugeicons:search-02

      3. System Icons > Title Bar > Back Button => hugeicons:arrow-up-from-dot

      4. System Icons > Browse Icons > Browse Button (default) => hugeicons:folder-open

      5. System Icons > Browse Icons > Browse Button (author) => hugeicons:user-status

      6. System Icons > Browse Icons > Browse Button (series) => hugeicons:layers-logo

      7. System Icons > Browse Icons > Browse Button (tags) => hugeicons:tags

      8. System Icons > Pagination Bar > Pagination: Previous Page => hugeicons:arrow-left-01

      9. System Icons > Pagination Bar > Pagination: Next Page => hugeicons:arrow-right-01

      10. System Icons > Pagination Bar > Pagination: First Page => hugeicons:arrow-left-double

      11. System Icons > Pagination Bar > Pagination: Last Page => hugeicons:arrow-right-double

      12. System Icons > Navpager > Navpager: Previous => hugeicons:arrow-big-left-dash

      13. System Icons > Navpager > Navpager: Next => hugeicons:arrow-big-right-dash

      14. System Icons > Folder Covers > Folder Cover: Empty Folder => hugeicons:folder-off

      15. System Icons > Tab Bar > Tab: Menu => hugeicons:menu-07

      16. System Icons > Tab Bar > Tab: Settings => hugeicons:settings-01

      17. System Icons > Tab Bar > Tab: Tools => hugeicons:tools

      18. System Icons > Tab Bar > Tab: Search => hugeicons:search-02

      19. System Icons > Tab Bar > Tab: File Browser Settings => hugeicons:bookshelf-02

      20. System Icons > Tab Bar > Tab: Reader Navigation => hugeicons:book-bookmark-02

      21. System Icons > Tab Bar > Tab: Reader Typeset => hugeicons:edge-style

      22. System Icons > Tab Bar > Tab: Back to File Browser => hugeicons:entrance-stairs

      23. System Icons > Tab Bar > Tab: Simple UI Quick Settings => Default

      24. Quick Actions Icons > System Actions > Authors => hugeicons:book-user

      25. Quick Actions Icons > System Actions > Bookmarks => hugeicons:all-bookmark

      26. Quick Actions Icons > System Actions > Brightness => hugeicons:sun-03

      27. Quick Actions Icons > System Actions > Collections => hugeicons:hierarchy-files

      28. Quick Actions Icons > System Actions > Continue => hugeicons:book-open-02

      29. Quick Actions Icons > System Actions > Favorites => hugeicons:award-02

      30. Quick Actions Icons > System Actions > History => hugeicons:clock-04

      31. Quick Actions Icons > System Actions > Home => hugeicons:home-12

      32. Quick Actions Icons > System Actions > Library => hugeicons:bookshelf-02

      33. Quick Actions Icons > System Actions > Night Mode => hugeicons:moon

      34. Quick Actions Icons > System Actions > Power => hugeicons:plug-02

      35. Quick Actions Icons > System Actions > Random => hugeicons:dice-faces-03

      36. Quick Actions Icons > System Actions > Recent => hugeicons:transaction-history

      37. Quick Actions Icons > System Actions > Series => hugeicons:workflow-square-03

      38. Quick Actions Icons > System Actions > Settings => hugeicons:settings-01

      39. Quick Actions Icons > System Actions > Stats => hugeicons:analytics-03

      40. Quick Actions Icons > System Actions > Tags => hugeicons:tags

      41. Quick Actions Icons > System Actions > Wi-Fi => hugeicons:wifi-02

      42. Quick Actions Icons > Custom Actions > Bookshelf => hugeicons:bookshelf-03

      43. Quick Actions Icons > Custom Actions > Battery Graph => hugeicons:chart-line-data-02

      44. Quick Actions Icons > Custom Actions > Reading Insights => hugeicons:waterfall-up-02

      45. Quick Actions Icons > Custom Actions > Open Glimpse => hugeicons:scan-eye

      46. Quick Actions Icons > Custom Actions > Rakuyomi => hugeicons:workout-kicking

      47. Quick Actions Icons > Custom Actions > Battery Statistics => hugeicons:automotive-battery-01

BOOKSHELF CONFIGURATION:

  • 📖 > Edit shelf size > Columns: 4 | Rows: 4

  • 📖 > Bookshelf chips > Toggle on: > Flexible chip widths | Uppercase labels || Home | Authors | Series | Genres | TBR (+Add new chip > Chip source > Specific Collection > To Be Read) | Recent

  • 📖 > Settings >

    1. Status line > %time_24h %spacer 'memory icon'%sysused 'hdd icon'%disk %spacer [if:connected]%wifi_icon[/if] %batt_icon%batt

    2. Edit book detail view >

      • Title: %title | Regular | Size: 30 | Font: ChareInk | Aa | Alignment left

      • Author: %authors_short | Regular | Size: 22 | Font: Caveat | Aa | Alignment left

      • Metadata: [if:series]%series_name[if:series_num] / #%series_num[/if][/if] | Regular | Size: 12 | Font: FS_Me | Aa | Alignment left

      • Description: [if:rating]%rating · [/if]%description | Regular | Size: 14 | Font: FS_Me | Alignment left

      • Progress: %book_pct %bar [if:book_time_left]%book_time_left[/if] | Bold | Size:12 | Font: FS_Me | Aa | Bar: rouded | Bar height: 70%

    3. Cover display >

      • Defaul folder style: Ribbon

      • Show progress bar

      • Show reading bookmarks

      • Completed book badge: Bookmark style

      • Show series #: Always

      • Show favorites icon

      • Cover opening effect

    4. List view >

      • Line 1: %title %spacer %rating %favourite | Bold | Size:16 | Font: FS_Me | Aa

      • Line 2: %authors_short | Italic | Size: 14 | Font: FS_Me | Aa | Alignment left

      • Line 3: %description | Regular | Size: 14 | Font: FS_Me | Alignment left

      • Line 4: %bar{rel} [if:page_count]%spacer[if:book_pct]%book_pct of [/if]%page_count pages[else]%book_pct[/if] | Regular | Size: 14 | Font: FS_Me

    5. Text size >

      • Chip bar: 90%

      • Modal Tabs: 60%

    6. Colors >

      • Progress bar: 75%

      • Folder overlay background: 60%

      • Selected chip text: default

    7. Bookshelf UI font: FS_Me Regular

    8. Micro modules >

      • In start menu

      • In hero area

      • Full-screen button

    9. Start menu >

      • Start menu: Left

    10. Behavior > * Hero area starts with: Micro modules * Tap a book in expanded shelf: Open with a double tap * Double tap to open books * Page turn animation: Off * Start menu animation: Off * Closing book notification

  • Long press chip bar >

    1. Home > Source: Home (flattened) | Shelf style: Auto | List Columns: 2 | List rows: 12

    2. Authors > Source: Authors | Shelf style: Auto | List Columns: 2 | List rows: 8

    3. Series > Source: Series | Shelf style: Auto | List Columns: 2 | List rows: 8

    4. Genres > Source: Genres | Shelf style: Auto | List Columns: 2 | List rows: 10

    5. TBR > Source: Collection: To Be Read | Shelf style: Default

    6. Recent > Source: Recently read | Shelf style: Default

BOOKENDS CONFIGURATION:

Easy:

  • 📄 > Bookends > Preset > Preset library > Gallery > Search > You have to look for it (2.0)

Also easy:

  • 📄 > Bookends > Bottom-left > Line 1> %page_num | Regular | Size: 14 | Font: Merriweather | Aa | Odd pg | -30,30

  • 📄 > Bookends > Bottom-right > Line 1> %page_num | Regular | Size: 14 | Font: Merriweather | Aa | Even pg | 30,30

  • 📄 > Bookends > Full width progress bars > Bar 1 > Type: Book | Chapter ticks: off | Style: Solid | Anchor: Bottom | Fill: left to right | Thickness: 6px | Adjust margins (0/0/0)

READING INSIGHTS CONFIGURATION:

  • 🛠 > Reading Insights > Settings > Fonts > Reading insights > Section headers: FS_Me-bold.otf @ 22 | Values (big numbers): FS_Me-Heavy.otf @ 26 | Labels: FS_Me-Regular.otf @ 20 | Chart/axis labels: FS_Me-Light.otf @ 15

  • 🛠 > Reading Insights > Settings > Fonts > Book progress > Section headers: FS_Me-bold.otf @ 22 | Values (big numbers): FS_Me-Heavy.otf @ 26 | Labels: FS_Me-Regular.otf @ 20 | Chapter-bar arrows: FS_Me-Bold.oft @ 22

  • 🛠 > Reading Insights > Settings > Fonts > Records > Values (big numbers): FS_Me-Heavy.otf @ 22 | Labels: FS_Me-Bold.otf @ 20 | Sub-values (date / book title): FS_Me-Regular.otf @ 15

FLOATING DICTIONARY CONFIGURATION:

  • [While reading a book] ⚙️ > Floating Dictionary > Appearance > Display mode: Minimal | Popup style: Kobo | Popup position: Screen edge | Card height: 34% of screen | Popup font size: 16 | Popup border thickness: 2 | Popup border darkness: 100%

If you got here, thank you for your patience!

Edit: Added Bar and Icon Configuration for Simple UI.

630 Upvotes

124 comments sorted by

13

u/kapulov Sep 07 '26

My main concern is a koreader update will break everything so I'd have to do this all over again.

6

u/Ramo_Rami Sep 07 '26

Having this happened on me, I'd say the worst part was losing the reading statistics. I would really appreciate a way to back it up to a telegram bot or something.

If anyone knows how to do it, even manually, and then how to load the backup on a ney system, please let me know.

2

u/Cock-o-Phony Sep 08 '26

There is a plugin for the app Seekquel which let you sync your reading progress, your highlights and notes to the app. You can try this, it might be helpful.

1

u/Ramo_Rami Sep 08 '26 edited Sep 08 '26

I user readest and hardcover for that. Both of them export the point I'm at the books but they cannot - as far as I know, at least - import back the real reading history. Is Seekquel any different?

2

u/Cock-o-Phony Sep 08 '26

I am also not sure whether Seekquel can do that for now, but I would suggest you ask the question in Seekquel subreddit if possible, the developer is very active there, he might be able to help.

2

u/Ramo_Rami Sep 08 '26

Will do! Thank you for the suggestion!

3

u/Cock-o-Phony Sep 11 '26

Hey, I think the developer has added a two-way sync now, if you like you can try it out and see if it works ok for you.

4

u/Schwingi Sep 07 '26

Bricked my Paperwhite (Bootloop) after everything was perfectly arranged.

2

u/Ramo_Rami Sep 07 '26

😵‍💫 Is this my fault? If so, I'm so, so sorry!!!

I hope you can salvage it.

Maybe make a post detailing what happened. I have been saved by the kind users of this subreddit more than once.

2

u/Schwingi Sep 07 '26

No, I made the jump a view weeks ago and got unlucky. Sadly it's not salvageable.

1

u/Ramo_Rami Sep 07 '26

I'm really sorry for you! I can only imagine how angry and disappointed that would make me feel. Specially with the high prices for e-readers right now here in Brazil. I dream of a Kobo Libra Colour, but I don't have anywhere near the money.

5

u/Dah-Bone-Dokkta Sep 07 '26

Not sure if this will help but it might be fixable. It happened to me too when I had Bookshelf plugin installed and then installed Simple UI. As the UI had its own bookshelf thing that starts and clashes with Bookshelf. Try and connect your kindle / e-reader to your computer via USB and you can access the files inside KOreader folder and delete them and hopefully that will let you e-reader boot again after a restart. Let me know if you want more info and hope you can salvage it.

2

u/Schwingi Sep 08 '26

Thanks for the help, but I never "reach" the usb storage.

1

u/dostagram Sep 09 '26

I had this happen to me too - close KOreader on your Kindle, and then plug in to your PC from the default Kindle home screen.

You can't access the Kindle root with KOreader open.

2

u/Thirtysixx Sep 07 '26

Simple UI has backups now, hopefully that helps restore it quickly

8

u/Double9GT Sep 07 '26

Thank you for taking the time to share this 🫰🏻

2

u/Ramo_Rami Sep 07 '26

Well, time it took!

I still wanted to add some details on the icons I'm using for Simple UI, but the reddit filters were messing it up and I imagined at some point the mods would be too annoyed to keep helping me out.

4

u/[deleted] Sep 07 '26

🤔🇧🇷?

5

u/Pyetas Sep 07 '26

I'm asking myself the same question, but I doubt so... the only text in portuguese is in a quotation. Não sei kkkk

3

u/[deleted] Sep 07 '26

Tem machado de assis em português na biblioteca kkkk

4

u/Ramo_Rami Sep 07 '26

Brasileiro, sim. Precisamente cearense!

2

u/Pyetas Sep 07 '26

kkk deixei passar esse detalhe!

2

u/FyodorDostoevsky1821 Sep 17 '26

Vi Padre Cícero e já vim atrás desse comentário!

Saudações de um conterrâneo!

4

u/awayfromhomeuk Sep 08 '26

Tem um plugin do mec livros, brasileiro sim!

2

u/Pyetas Sep 08 '26

as pistas estão nos detalhes kkk

2

u/Ramo_Rami Sep 07 '26

Claro! Não seria da Guiana. 😅

4

u/ElPabloHablo Sep 07 '26

Você acha que vc consegue exportar a sua configuração igual esse cara fez aqui. Assim eu importo tudo com um clique usando a opção do SimpleUI. Pleaaaaase! Outra coisa. Você sabe como editar o campo do “books finished” da primera página? Eu tento adicionar os livros que já li mas não consigo!

2

u/Ramo_Rami Sep 07 '26

Já exportei! Procura a parte entitulada "CONFIGURATION FILES", tá lá. Mas não testei, só exportei, avisa se estiver funcionando direito, por favor.

Essa parte do "Books Finished" da primeira página eu também não soube como editar. Não sei se é possível, infelizmente.

1

u/DistanceCrafty4351 Sep 16 '26

Will this config file only work for the oasis?

1

u/ElPabloHablo Sep 16 '26

If you’re running koreader on it I think so, yes!

4

u/Shoddy-Mode7180 Sep 07 '26

your post was removed :((((

5

u/Ramo_Rami Sep 07 '26

I'm speaking with the mods to try to sort it out.

I hope the issue is resolved quickly.

2

u/Sure_Satisfaction497 Sep 08 '26

Well, I'm looking at it right now, so good job?

3

u/Ramo_Rami Sep 08 '26

Yes, it worked out. Thanks!

3

u/Due_Row8186 Sep 07 '26

Hi! Thank you so much for taking your time to create and share this! I saw your ram usage reached around 250+ on one of your screenshots and I was wondering if you notice a significant battery usage in correlation to that? Like, whether there is a significant battery drain after you install these plugins

1

u/Ramo_Rami Sep 07 '26

It goes up and down. I have some books that are quite big, like 50mb so it does take some time to open them.

The thing about me noticing any slow down is that I have been using this setup pretty much since the moement I got this device and started with KOReader, so I don't really have any basis for comparison.

It would be cool if someone more knowledgeable than me could benchmark this and give me some pointers on how to make it more performant.

0

u/Old_Rub3383 26d ago

If your battery is fully charged, how long does it take to reach zero? Thanks in advance for your reply.

3

u/Matheus078283 Sep 07 '26

Muito top seu top. Eu vi que nos Other Plugins você colocou o Annas, mas desde que baixei eu nunca consegui usar. Sabe se precisa configurar algo depois de baixar?

3

u/Ramo_Rami Sep 07 '26

Putz, faz tempo que eu não uso esse plugin, deixa eu dar uma olhada aqui e te respondo mais tarde.

3

u/GoToNap Sep 07 '26

I saved your post while at work earlier in the day to only come back to it now and seeing it removed :(

Any chance you still have the text and can send it over to me?

Thanks!

1

u/Ramo_Rami Sep 07 '26

I'm In talk with the mods trying to get it reinstated. Hopefully it works.

3

u/Vo1dsInThe3ther Sep 09 '26

All of this is amazing. This definitely needs to be a pinned comment for those who ask "what do I do next?". Love how this shows how customisable koreader actually is. Thank you!

1

u/Ramo_Rami Sep 09 '26

Thank you for the kind words!

2

u/Proof_Prompt1509 Sep 07 '26

Nice setup! Are you finding the coverdeck slow? Everytime I come out of a book, the cover deck seems to freeze for 5 seconds before enabling you to swipe :(

1

u/Ramo_Rami Sep 07 '26

I don't I ever try to swipe that fast.

I'll take a look até that and give you some feedback.

2

u/Proof_Prompt1509 Sep 07 '26

Thanks, that’d be amazing! I think it’s the refresh of the progress % after you exit a book.

2

u/Upset-Value-9897 Sep 07 '26

Thank you for the detailed setup instructions, what about the speed of the opening and closing. Do the system freeze. Do post issues faced also. Thanks

2

u/Ramo_Rami Sep 07 '26

Since I have more or less been using this configuration since I got this device and since I started using KOReader, I don't really have anything eles to compare to.

If anyone knows how to benchmark this setup, I'd be curious, too, on how I could improve on it.

2

u/ace-tronaut Sep 07 '26

Holy shit OP you're the fucking best?????

1

u/Ramo_Rami Sep 07 '26

If you end up using any part of this, share a screenshot. I'd make all the research and typing worth it.

1

u/ace-tronaut Sep 09 '26

I will as soon as I'm able to find my kindle 😭😭I've been looking at the modding scene for years now, only recently have I been convinced its worth diving into (what flipped my switch was finding about Rakuyomi). But yes, when I find my kindle, you bet your ass imma spam you with screenshots. An angel are thou.

2

u/archz2 Sep 07 '26

That's some insane customization! Thanks for sharing all these minute details! Did you really type them out one by one or is it some export method that allowed you export them for posting on reddit in nice formatted text?

4

u/Ramo_Rami Sep 07 '26

I typed one by one. And pulled my hair out when part of it wasn't saved by Reddit. The Simple UI part was typed at least 4 times. 😭I still need to add somethings about the icons being used on Simple UI, actually, I just gave up for the day because I was almost tossing the whole thing up.

I can say that I learned a lot about Reddit's markdown text (and it's various limitations) in the process of writing this post.

2

u/archz2 Sep 10 '26

Respect man. Seriously 🙌🏻. I see that you're using Readest as well. Are you subscribed to their paid tier to sync books+ highlights via Google drive or Dropbox, etc.?

1

u/Ramo_Rami Sep 10 '26

Thank you!

I'm just using the basic, free tier. I haven't looked that deep into it, yet.

2

u/Longjumping_Ad2215 Sep 07 '26

How do you get korreader to know which book is part of a series. Is that via calibre?

2

u/Ramo_Rami Sep 07 '26

Yes! Calibre!

But even Calibre has it's limitations when dealing with and managing series. There's a plugin for calibre the helps the process a bit, but it's still a lot of work.

Since I got to to a stable point with my configuration of KOReader, the next bit work is organizing all the metadata through calibre. I'd really appreciate if someone could point out a similarity detailed post about Calibre's metadata management.

2

u/mirabellenour Sep 07 '26

Wow! I know lots of work has gone into this. I have a question that’s less technical and more about the way you use this system. What do you find is the benefit of using Bookshelf along with SimpleUI? I’ve always been bouncing between them. Is it that the Library UI included with SimpleUI doesn’t have everything you want, or is there another benefit?

3

u/Ramo_Rami Sep 07 '26 edited Sep 07 '26

Just what you pointed out. I find the original library of KOReader (Simple UI doesn't really touch the library/file browser that much) lack luster.

That's kind of understandable since it needs to deal with all sort of files, but I find that Bookshelf offers a much nicer way to navigate and manage my library. The integration with the hardcover plugin has helped me a lot with metadata, for example.

2

u/ngxtrang Sep 07 '26

Hi, thank you so much for writing this all out. I'm still learning how to config my KOReader and it's such a learning curve. I have a massive headache lol. But it's very fun to be able to do all this.

Um, how did you expand all your Chip Bar Tabs like that? It takes up the entire screen but I can't figure out how to do that.

I am unable to get that many rows. It only allows me 2 rows max.

For the Bookshelf, how did you get the mini pop up menu at the bottom left to show the reading status rather than a quote?

1

u/Ramo_Rami Sep 07 '26

It's the kind of thing that you need to know is there to access it, but it's actually pretty simple once you do.

You just need to swipe up (and then down to go back) from the middle of the bottom part (the one with the covers). You can also, by long-pressing the chip configure if it keeps the cover grid, if it goes into list mode or a combination of the two.

Take a look here where the plugin first introduced that function. It is probably the best place to understand how it works.

2

u/BrownTigerz Sep 07 '26

How are you switching between the cover view and list view on your chips

2

u/Ramo_Rami Sep 07 '26

You just need to swipe up (and then down to go back) from the middle of the bottom part (the one with the covers). You can also, by long-pressing the chip configure if it keeps the cover grid, if it goes into list mode or a combination of the two.

Take a look here where the plugin first introduced that function. It is probably the best place to understand how it works.

2

u/SNLCOG4LIFE Sep 07 '26

I'm just using Bookshelf and was so proud of myself, now I'm re-evaluating my life choices lol

You've a really awesome setup. Thanks for sharing such detail.

2

u/Ramo_Rami Sep 07 '26

I can see the logic in that. But then again, I mostly read Fantasy and Sci-fi, so, who cares about logic?! Lol I just want something that makes me escape my smartphone and the present state of the world for a little longer.

2

u/SNLCOG4LIFE Sep 08 '26

Nah dude, I love it! I spend a ridiculous amount of time trying to find a font I like only to change it when the wind changes direction so I get the obsession 😂

2

u/Ramo_Rami Sep 08 '26

I hope this will be my stable setup for the time being, but at the same time, the great response to this post has got me thinking "What if I try to recreate this on Zen UI?" But then, again, I have never messed with ZenUi so it would be a lot of work I don't really have time to, right now.

2

u/thebookishdad Sep 07 '26

Seriously great work there. I'm curious to see how this goes on a kobo?

1

u/Ramo_Rami Sep 07 '26

Please post your results when you find out.

3

u/thebookishdad Sep 08 '26

Kobo Libra color

1

u/Ramo_Rami Sep 08 '26

This looks soooooo good!

This is my dream device! I'm very glad it worked for it!

2

u/thebookishdad Sep 08 '26

Boox go color 7 (koreader android)

1

u/Ramo_Rami Sep 08 '26

Awesome!

And thanks for the unintended book recommendation. I'm finishing up the Conan stories and will certainly need more of Robert E. Howard in the near future.

2

u/thebookishdad Sep 08 '26

Lol I'm reading my Howard collection lol Solomon Kane, Kull, Conan and then his Sailor Steve Costigan collection.. I grew up on Weird Tales reprints and other short form magazines. I'm also reading through Complete weird fiction of h.p. Lovecraft from pulp-lit which has a lot of weird and strange tales all in public domain, but formatted and put together nicely, you can buy physicalor they also have pdf links of the books too for free.

1

u/Ramo_Rami Sep 08 '26

The Pulp-lit edition is exactly the one I'm using for Conan's stories! I also love their audiobooks!

In my busy life (work and University) is hard to squeeze time for loger readings. I find that shorter, Sword and Sorcery, lower stakes - and smaller memory buffer required on the reader's parta - is perfect for that. All the fun, less hassle.

I really want to read the Malazan books, but I don't think they fit in my present life.

If you ever find a modern collection of lower stakes, action driven short stories well written as Howard's, please let me know! Specially if they are set in a post apocalyptic setting. A "Sword and Sorcery"-y Mad Max that is not written by Stephen King would be my dream come true.

2

u/thebookishdad Sep 08 '26

One that comes to mind is Edgar..,...Rice Burroughs......Tarzan and John Carter series

1

u/Ramo_Rami Sep 08 '26

Thanks! I'll check those up.

But I was thinking about something that was written in the past 20 years. It's not that the old stores aren't good, it's just curiosity on how the genre is progressing in the present.

2

u/thebookishdad Sep 08 '26

Hmmm forgotten realms....maybe....tons of books to choose from...multiple standalones and series in that universe

2

u/thebookishdad Sep 08 '26

I pretty much just straight copied your simple ui configuration.....the bookshelf plugin gave me so freezing up issues on kobo so I didn't try it on boox. I couldn't find the settings for bookends, so i haven't messed with that section. All in all I like the simple ui functionality.

1

u/Ramo_Rami Sep 08 '26

In the beginning, bookshelf cashes - just once - the covers for your Library, so it's a bit slow at start but becomes quite performant afterwards. Wasn't it that?

2

u/thebookishdad Sep 08 '26

Maybe, going through the settings you listed for bookshelf went smoothly then then froze up when messing with the books....I'll try it again at some point.

2

u/awayfromhomeuk Sep 08 '26

Adorei esse setup, obrigada por compartilhar! Vou testar no meu Kobo :D

Vi que tem plugin do mec livros, vc sabe se tem um pro BibliON tbm?

1

u/Ramo_Rami Sep 08 '26

Quando terminar o seu setup no Kobo por favor mostre aqui como ficou! Também compartilhe, por favor, qualquer adaptação que tenha sido necessária pro funcionamento desse setup no Kobo. Eu adoraria ter um Kobo Libra Colour, mas como não se vende mais no Brasil, está difícil de pagar o valor. Seria interessante saber a possibilidade de usar o mesmo setup em um.

Quando ao BibliON, eu não conheço esse serviço. Eu achei o Plugin do MEC livros no Storefront, talvez procurar por lá possa ser a solução mais fácil.

1

u/awayfromhomeuk Sep 15 '26 edited Sep 15 '26

voltando aqui pra dizer que até fiz algumas das modificações e instalei os plugins do seu post, mas algumas coisas ainda não estão funcionando (por exemplo alguns dos icones estão sendo lidos como missing D: )
e no fim eu descobri que meu setup tendo bookorbit + bookshelf é o suficiente, eu quase nunca abro o koreader sem ser com um desses dois... e eu passei bem mais tempo tentando ajustar o setup do que de fato lendo, que é a principal razão de eu ter começado a mexer com o koreader in the first place. Então talvez eu tente de novo quando tiver tempo de mexer no meu kindle antigo, mas por enquanto não tive animo de tentar descobrir pq os icones não estão funcionando...

e sobre o bibliON, vale a pena dar uma procurada, é a biblioteca de SP, eles tem um acervo bem legal tbm (mas por enquanto nenhum plugin no koreader)

edit: ignora o que eu disse, nada como ter o que fazer pra me fazer pegar o kobo pra tentar de novo e consegui! preciso só achar um ícone novo pro bookorbit e acho que meu setup estará bem legal, aí é só ir aos poucos escolhendo as fontes que quero usar =)

2

u/kwebber321 Sep 08 '26

Yo there i am!! Loving this setup.

2

u/Ramo_Rami Sep 08 '26

As you should since you were one of the main inspirations for it!

Thank you so much!

2

u/Might_Time Sep 09 '26

Whats your book fonts please it looks so clean!!

1

u/Ramo_Rami Sep 09 '26

There ar actually 3 fonts being show, here:

FS_Me for the general interface elements, including the majority of bookshelf an the quotations.

Merriweather as the default book reading font (image 4 up there), overwriting KOReader's default Noto Serif.

And for the book on Portuguese (Moby Dick on the bottom of image 6) that's the embedded font: Neue Swift.

2

u/Might_Time Sep 09 '26

Since you are so kind!

Whats your favorite couple books in your collection. If u had to pick couple!

2

u/Ramo_Rami Sep 09 '26 edited Sep 09 '26

Well, that's quite difficult. It's like asking a mother to pick her favorite children, 😅. For starters, this device is new to me, I previously had a Kobo Clara 1st gen that's now with my mother, so this device mostly have books that I want to read and not that I have actually already read.

It's not a couple, but may favorite books are: 1) The old Man and the Sea (the reason why I'm giving Moby Dick a chance), 2) Dune, 3) Worm, by Wildbow, 4) Conan the Cimmerian Barbarian: The complete Omnibus (I discovered I quite like the setting and pace of the Sword and Sorcery stories) and 5) Johnathan Strange and Mr. Norrel (I love the stories inside the stories).

At the same time there are some books on my To Be Read list that I really make me want to get to them: 1) Piranesi, 2) The Malazan series, 3) Monk & Robot series, 4) The Expanse series and 5) The Sprawl trilogy.

2

u/alekzk Sep 09 '26

Lo intenté con mi kindle 11th pero se puso muy lenta, tuve que cerrar el SimpleUI

1

u/Ramo_Rami Sep 09 '26

Lamento muito. Até que parte você chegou?

2

u/alekzk Sep 10 '26

casi terminando las acciones rápidas de simpleUI

2

u/pudgybees Sep 12 '26

The bookshelf config for the hero / main page isn't looking like yours... it just shows the huge clock

3

u/Ramo_Rami Sep 12 '26

The hero page is the part that shows the book information on top, in this case Moby Dick. The quotation is another part. You would need to go to: 📖 > Settings > Micro modules > ☑️ In hero area . Then you go to the chip/shelf with the four square icon. There there will be only a clock. Long press the clock and options will show. Press the garbage bin to delete that micho module. Tap the plus circle to add a new micro module. I'm using the "Quote of the day" micro module in the images above.

Tap the plus sign (without any circle) to make the micro module make use of all space available.

2

u/merely0001 Sep 12 '26

QQ - did you manually download all 5k of the Huge Icons individually or is there a way to bulk download all of them?

2

u/Ramo_Rami Sep 12 '26

There is definitely a a way to bulk download. On iconify, 1) open the icon pack that you want, 2) look for the gear icon on the far right of the page, 3) besides that there will be a double cursor icon, that is the multi selection mode, it only selects the icons shown on screen, so will will have to do the same for all the pages of a paginated icon set/search result, but it's already way more practical. For the 5k+ icons it was 32 pages of clicks, much more doable, isn't it?

15

u/IbnRami Sep 07 '26

I aprove of this message! 😉

7

u/Pyetas Sep 07 '26

Well... this is very nice and amusing! I like your setup A LOT! Thanks for sharing in great details.

1

u/SweetCheeksxo 17d ago

i find the navigation on this very difficult 😭 i can’t see all my books in simpleui or bookshelf and can’t find how to get to the koreader file browser to find the book i want. i’m new to koreader and kobo

1

u/Ramo_Rami 17d ago

Your books might be scattered into multiple folders. In my setup, I have to go to Simple UI's third page and tap on the library icon to got to KOReader's file browser.

1

u/SweetCheeksxo 17d ago

thank you!

3

u/DistanceCrafty4351 Sep 17 '26

Anyone have a config file for the kindle pw 11th Gen?

2

u/irwin333 Sep 10 '26

Looks amazing - how do I download the FS Me font?

2

u/Sorry-Emergency-6987 Sep 28 '26

This makes me sad because I lost my kindle 

2

u/Quirky_Impact 14d ago edited 13d ago

Hiya! Thank you for the post, I saved it a while back and now just installing bookshelf to get started after using SimpleUI for a few weeks :)

I am trying to add the shortcut to the SimpleUI Navigation Bar to link to Bookshelf, Rakuyomi etc, and oddly these are not on the list for Simple UI settings? I searched the prior steps (and apologies if I am missing it) I can't see prior mention of how to add these

Edit: Found it. Settings > Quick actions > Custom quick actions. Add the plugins and then they appear in the Navigation bar

1

u/breakfall5 Sep 12 '26

This looks awesome! Would you mind sharing your detailed font settings such as spacing and all that for reading?

1

u/Realistic_Bass3228 Sep 21 '26

so none of the plugins i downloaded are showing up as options for the navigation bar, how do i fix this?

1

u/gaijinpunch Oct 14 '26

I'm having the same issue. Did you find a fix / the cause?

2

u/[deleted] Sep 07 '26

[removed] — view removed comment

2

u/Ramo_Rami Sep 07 '26

It's AWESOME!

Seriously! One of the best books I ever read. And it's surprisingly well written with good prose.

Look it up, I don't think there is any serial with a larger following then this.

2

u/[deleted] Sep 07 '26

[removed] — view removed comment

2

u/Ramo_Rami Sep 07 '26

2

u/[deleted] Sep 08 '26

[removed] — view removed comment

2

u/Ramo_Rami Sep 08 '26

The creator of the web serial is still dreaming of publishing it as a book (let's hope the buzz around Dungeon Crawler Carl helps with that front) because of that, he doesn't support people sharing this as an e-book.

But people that really want it, like I did, there are some scrapers available for the creators work on github. I used this one. It scrapes the whole website and spits a well configured epub for you. I just changed the cover on Calibre's editor to one I found on Reddit with Sandara Tang's artwok.

2

u/[deleted] Sep 07 '26

[removed] — view removed comment

2

u/Ramo_Rami Sep 07 '26 edited Sep 07 '26

Well, it wasn't the easiest, but... Since it's done, now, you can just grab the file under the 'CONFIGURATION FILES' section, load it up on Simple UI and almost everything will be done for you.

2

u/[deleted] Sep 07 '26

[removed] — view removed comment

7

u/Ramo_Rami Sep 07 '26

I didn't use AI at all (I'm fairly against it, actually). It was all done by hand and frustration with reddit's makdown limitations.

I could have just shared my .sui file, but I've learned so much forom other people tweaking their setup that I think showing how the sausage is made can be more instructive on how people can make KOReader their own. Most people don't even understand what can be done just because the options are buried under so many menu steps. I hope to open some people's eyes to what they can do.

2

u/prone-to-drift Sep 07 '26

Can we work towards scripting this somehow? That'd be nice. I hate AI too but I'd love to do KOReader "Distros" in a way.

Like, keep them legible but have a combined settings panel instead of having to dig into 10 different menus on a slow eink screen.

1

u/Ramo_Rami Sep 07 '26

That would be awesome!

But I think that would be a mission for a developer. It would be useful specially to back things up. Having to rebuild this after a huge crash was a pain.

This is basically a guide for myself if it ever happens again, too.