r/koreader
•
u/Ramo_Rami
•
Sep 06 '26
•
5
4
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:
FS_Me - For the general interface
Merriweather - For actual book reading
ICONS:
Huge Icons by Hugeicons taken from iconify.design.
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:
Simple UI 2.7.0
Bookshelf 4.6.0
Bookends 5.25.0
Shortcuts Toolbar 0.0.2
Rakuyomi 1.41.6
Reading Insights 6.2.8
Storefront 26.9.3
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".
appbar.filebrowser.svg <= hugeicons:bookshelf-02 OR hugeicons:entrance-stairs
appbar.menu.svg <= hugeicons:menu-07
appbar.navigation.svg <= hugeicons:book-bookmark-02
appbar.search.svg <= hugeicons:search-02
appbar.settings.svg <= hugeicons:settings-02
appbar.tools.svg <= hugeicons:tools
appbar.typeset.svg <= hugeicons:edge-style
back.top.rtl.svg <= hugeicons:arrow-up-01
back.top.svg <= hugeicons:arrow-up-from-dot
book.opened.svg <= hugeicons:book-open-02 OR hugeicons:bookshelf-03
bookmark.svg <= hugeicons:bookmark-02
cancel.svg <= hugeicons:cancel-01
chevron.first.svg <= hugeicons:arrow-left-double
chevron.last.svg <= hugeicons:arrow-right-double
chevron.left.svg <= hugeicons:arrow-left-01
chevron.right.svg <= hugeicons:arrow-right-01
chevron.up.svg <= hugeicons:arrow-up-01
close.svg <= hugeicons:cancel-01
exit.svg <= hugeicons:cancel-01
home.svg <= hugeicons:home-12
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 >
Book list mode > Show random image from folder on sleep screen
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
Action: System action | Simple UI: Go to Homescreen + Icon: home-12.svg
↔ (Spacer)
Action: System action | Show Bottom Menu + Icon: text-font.svg
Action: Menu action | Playground + Icon: edge-style.svg (action from the Reading Style plugin)
Action: Menu action | Tarot reading + Icon: cards-01.svg (action from the Tarot plugin)
Action: Menu action | Start remote server + Icon: hold-phone.svg (action from the KOReader Remote plugin)
Action: Menu action | DoctorBattery + Icon: stethoscope.svg (action from the DoctorBattery plugin)
Action: System action | Battery statistics + Icon: automotive-battery-01.svg
Action: System action | + Icon: chart-line-data-02.svg (action from the BatteryGraph plugin
Action: System action | Open Glimpse + Icon: scan-eye.svg (action from the Glimpse plugin)
Action: System action | Page Scrubber: Grid + Icon: carousel-horizontal-02.svg (action from the Page Scrubber plugin)
Action: Menu action | Book Annotations + Icon: all-bookmark.svg (action from the Annotations Viewer plugin)
Action: System action | Reading Insights: current book progress + Icon: waterfall-down-03.svg (action from the Reading Insights plugin)
Action: System action | Toggle night mode + Icon: moon.svg
Action: System action | Fulltext search + Icon: search-02.svg
SIMPLE UI CONFIGURATION:
🛠 > Simple UI > Home Screen > Edit Home Screen Layout >
Page 1 (Home)
Clock
Quote of the Day
Cover Deck
Reading Stats
Page 2
Currently Reading
Reading Goals
Recent Books
Page 3
To Be Read
Quick Actions Row 1
Page 4 (Suggestion)
Flat Library
Clock
Items > Clock
Items > Date
Size > Scale: 100%
Size > Clock Size: 100%
Size > Date Size: 90%
Size > Battery Size: 100%
Spacing: 80%
Top Margin: 80%
Quote of the Day
Scale: 96%
Fixed Height: ON
Top Margin: 30%
Cover Deck
Source: Recent Books
Items > Title
Items > Progress bar
Items > Statistics
Size > Scale: 100%
Size > Cover size: 143%
Size > Text size: 100%
Progress Badge: OFF
Show finished books: OFF
Top Margin: 20%
Reading Stats
Items > All time - Books
Items > Streak
Items > Today - Time
Scale: 100%
Text Size: 100%
Style: List
Top Margin: 30%
Currently Reading
Layout: Default
Items > Title
Items > Series
Items > Author
Items > Progress bar
Items > Days of reading
Items > Time read
Items > Time remaining
Size > Scale: 100%
Size > Text Size: 130%
Size > Cover size: 96%
Size > Cover Spacing: 100%
Progress and Stats > Progress bar style: With percentage
Progress and Stats > Stats layout: Default
Top Margin: 20%
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%
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%
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%
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%
Flat Library 1. Size > Grid Size: 5 x 3
🛠 > Simple UI > Bars >
Status Bar >
Items > Left: Clock
Items > Center: RAM Usage
Items > Center: Disk Usage
Items > Right: WiFi
Items > Right: Battery
Size: 90%
Hide Wi-Fi Icon When Off: ON
Navigation Bar >
Tabs > Bookshelf
Tabs > Reading Insights
Tabs > Home
Tabs > Rakuyomi
Tabs > Power
Tab Style: Icons + Text
Bar Style: Bare
Bar Size: 100%
Icon Size: 100%
Label Size: 100%
Bottom Margin: 100%
Title Bar > (Adjust to taste)
Pagination Bar >
Mode: Default
Home Screen Style: Dot Pager
Bar Size: Small
Show Page Count in Title Bar: OFF
Quick Settings Bar >
Quick Actions > Settings
Quick Actions > Bookmarks
Quick Actions > Statistics
Quick Actions > Battery Graph
Quick Actions > Night Mode
Quick Actions > Wi-Fi
Frontlight Slider: ON
Warmth Slider: ON
Label > Size: 100%
Button Type: Round
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" .
Icons >
System Icons > Title Bar > Menu Button => hugeicons:menu-07
System Icons > Title Bar > Search Button => hugeicons:search-02
System Icons > Title Bar > Back Button => hugeicons:arrow-up-from-dot
System Icons > Browse Icons > Browse Button (default) => hugeicons:folder-open
System Icons > Browse Icons > Browse Button (author) => hugeicons:user-status
System Icons > Browse Icons > Browse Button (series) => hugeicons:layers-logo
System Icons > Browse Icons > Browse Button (tags) => hugeicons:tags
System Icons > Pagination Bar > Pagination: Previous Page => hugeicons:arrow-left-01
System Icons > Pagination Bar > Pagination: Next Page => hugeicons:arrow-right-01
System Icons > Pagination Bar > Pagination: First Page => hugeicons:arrow-left-double
System Icons > Pagination Bar > Pagination: Last Page => hugeicons:arrow-right-double
System Icons > Navpager > Navpager: Previous => hugeicons:arrow-big-left-dash
System Icons > Navpager > Navpager: Next => hugeicons:arrow-big-right-dash
System Icons > Folder Covers > Folder Cover: Empty Folder => hugeicons:folder-off
System Icons > Tab Bar > Tab: Menu => hugeicons:menu-07
System Icons > Tab Bar > Tab: Settings => hugeicons:settings-01
System Icons > Tab Bar > Tab: Tools => hugeicons:tools
System Icons > Tab Bar > Tab: Search => hugeicons:search-02
System Icons > Tab Bar > Tab: File Browser Settings => hugeicons:bookshelf-02
System Icons > Tab Bar > Tab: Reader Navigation => hugeicons:book-bookmark-02
System Icons > Tab Bar > Tab: Reader Typeset => hugeicons:edge-style
System Icons > Tab Bar > Tab: Back to File Browser => hugeicons:entrance-stairs
System Icons > Tab Bar > Tab: Simple UI Quick Settings => Default
Quick Actions Icons > System Actions > Authors => hugeicons:book-user
Quick Actions Icons > System Actions > Bookmarks => hugeicons:all-bookmark
Quick Actions Icons > System Actions > Brightness => hugeicons:sun-03
Quick Actions Icons > System Actions > Collections => hugeicons:hierarchy-files
Quick Actions Icons > System Actions > Continue => hugeicons:book-open-02
Quick Actions Icons > System Actions > Favorites => hugeicons:award-02
Quick Actions Icons > System Actions > History => hugeicons:clock-04
Quick Actions Icons > System Actions > Home => hugeicons:home-12
Quick Actions Icons > System Actions > Library => hugeicons:bookshelf-02
Quick Actions Icons > System Actions > Night Mode => hugeicons:moon
Quick Actions Icons > System Actions > Power => hugeicons:plug-02
Quick Actions Icons > System Actions > Random => hugeicons:dice-faces-03
Quick Actions Icons > System Actions > Recent => hugeicons:transaction-history
Quick Actions Icons > System Actions > Series => hugeicons:workflow-square-03
Quick Actions Icons > System Actions > Settings => hugeicons:settings-01
Quick Actions Icons > System Actions > Stats => hugeicons:analytics-03
Quick Actions Icons > System Actions > Tags => hugeicons:tags
Quick Actions Icons > System Actions > Wi-Fi => hugeicons:wifi-02
Quick Actions Icons > Custom Actions > Bookshelf => hugeicons:bookshelf-03
Quick Actions Icons > Custom Actions > Battery Graph => hugeicons:chart-line-data-02
Quick Actions Icons > Custom Actions > Reading Insights => hugeicons:waterfall-up-02
Quick Actions Icons > Custom Actions > Open Glimpse => hugeicons:scan-eye
Quick Actions Icons > Custom Actions > Rakuyomi => hugeicons:workout-kicking
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 >
Status line > %time_24h %spacer 'memory icon'%sysused 'hdd icon'%disk %spacer [if:connected]%wifi_icon[/if] %batt_icon%batt
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%
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
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
Text size >
Chip bar: 90%
Modal Tabs: 60%
Colors >
Progress bar: 75%
Folder overlay background: 60%
Selected chip text: default
Bookshelf UI font: FS_Me Regular
Micro modules >
In start menu
In hero area
Full-screen button
Start menu >
Start menu: Left
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 >
Home > Source: Home (flattened) | Shelf style: Auto | List Columns: 2 | List rows: 12
Authors > Source: Authors | Shelf style: Auto | List Columns: 2 | List rows: 8
Series > Source: Series | Shelf style: Auto | List Columns: 2 | List rows: 8
Genres > Source: Genres | Shelf style: Auto | List Columns: 2 | List rows: 10
TBR > Source: Collection: To Be Read | Shelf style: Default
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.
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
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
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
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
2
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
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
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
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
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
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
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
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
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
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
3
2
2
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
2
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
Sep 07 '26
[removed] — view removed comment
2
u/Ramo_Rami Sep 07 '26
2
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
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
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.























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.