Customize Your KOReader Experience: Header Status Bar

Jan 17, 2026 by Editorial Team 54 views

Hey everyone! 👋 Ever felt like the footer status bar in KOReader just wasn't your vibe? Maybe it's a bit distracting, or perhaps you just crave more control over your reading experience. Well, you're not alone! I've been there, and after tinkering with a few patches and a little help from GitHub Copilot (shoutout to that amazing tool!), I've cooked up a fully customizable header status bar that I think you'll dig. This is all about giving you the power to tailor your reading setup exactly how you want it. This allows you to personalize your reading layout by moving the status bar to the top, which will reduce distractions and customize the information display. This whole thing started because, like many of you, I found the footer bar a bit of a buzzkill. It just wasn't in the right spot for me, you know? While the alt status bar was in a better location, it wasn't customizable enough. So, I took matters into my own hands and created a header status bar that's all about YOU.

Why a Customizable Header Status Bar? 🤔

So, why bother with a custom header status bar in the first place, right? Well, for starters, it's all about reducing distractions and enhancing focus. When the status bar is at the bottom, it can sometimes pull your eyes away from the text, especially if you're like me and have a tendency to glance down to check the time or progress every few seconds. By moving it up top, it's less in the way, allowing you to stay immersed in your book. But it's not just about location; it's also about personalization. We all have different preferences. Some of us want to see the author and title, others prefer the current time and battery life, and some just want a clean progress bar. With this custom header, you get to choose what information is displayed and how it's presented. This means you can create a reading experience that's tailored to your exact needs and preferences. In addition, it is about enhanced control and better readability. The default footer might not always provide the information you want in a way that's easy to digest. With the custom header, you can rearrange elements, adjust fonts, and add separators to make everything clear and accessible. It's about optimizing your reading environment for maximum enjoyment. Finally, it's about improving the aesthetics. The default footer might not always fit the overall look and feel of your reading experience. The custom header, on the other hand, allows you to create a sleek and modern display that complements your book and your device.

This customization also caters to those who, like me, find the original footer a tad distracting. By bringing the status bar to the top, we're not just moving things around; we're creating a more focused reading environment. It's about putting the important info – like the time, progress, and battery – right where you need it, without cluttering up the bottom of the page. This is great for you guys who love to tweak and fine-tune your tech. It gives you the power to set up your reading experience just the way you like it. I wanted something that wasn't just functional but also looked good and felt intuitive. I'm all about a clean, distraction-free reading setup, and that's what this header is designed to achieve.

Diving into the Customization Options 🛠️

Alright, let's get into the nitty-gritty of what you can customize with this header status bar. We're talking about a whole suite of options to make your reading experience perfect. First up, we've got the header items. You can set up two custom text fields that act as separators, or whatever you want. This is awesome for adding things like author names, chapter titles, or even just some stylish dividers to keep everything organized. Then there's the separator style. You've got your predefined styles, but you can also create custom ones to match your personal flair. This adds a unique touch to your header and helps you create a cohesive look. For the header font settings, you can adjust the size and boldness of the text. This is perfect for ensuring that the information is easy to read. This is particularly useful if you have less-than-perfect eyesight or simply prefer a certain font style. Adjust the text size, make it bold, and you're good to go. You can also customize the margins, including the top and sides. Plus, you can set the progress bar's top margin to get everything lined up just right. This gives you precise control over the layout. You can define the space between the header items and the progress bar. This way, the information is displayed in a clear and organized manner. Finally, we have the progress bar. You can show or hide it entirely, adjust the height, and even add chapter marks. This allows you to easily track your progress through the book. This is one of the most useful features. You can make it visible to quickly see the reading status, show it with chapter marks, or hide it if you prefer a cleaner look. I've also included fixes and changes to prevent those annoying crashes, like fixing the time-to-finish calculations and adding a leading zero to the current time. Plus, you'll see the progress percentage inside brackets, which is a small but helpful visual cue.

Cool Features and Fixes 🚀

I've made sure to include some awesome features and fixes to make your experience smooth and enjoyable. Let's break it down:

Tap to Show/Hide: You can tap the top area to show or hide the header status bar. This allows you to quickly hide the header to enjoy a full-screen view. This is super handy when you want a completely clean reading experience.
Footer Status Bar Items: I've integrated most of the items from the footer status bar into the header. This makes sure you still have access to the essential information you need. You'll find the time, battery status, page numbers, and all the usual suspects.
Overlay Design: The header bar is designed as an overlay, so you can adjust your book margins to ensure everything looks perfect. This means you can customize the margins to match the header, so the information doesn't overlap with the text. This gives you a clear and unobtrusive layout.
No Auto-Update: I've decided not to include auto-updates. I wasn't sure if it was useful or not, so I left it out. If you like the feature, you can always add it. This is more of a preference thing, so I left it out to keep things simple. It gives you more control over the software on your device.
Reflowable Documents Only: This feature only works in reflowable documents. If you primarily read PDFs or image-based books, it might not work as intended.

I've also made some key fixes and changes to enhance the overall stability and functionality:

Time Calculation Fixes: I fixed the crashing issues related to calculating the time remaining to finish the book and chapter. This ensures that the time display is always accurate and reliable.
Leading Zero for Time: The current time now displays with a leading zero. This is a small but significant detail that improves the visual presentation and makes the time easier to read.
Progress Percentage: The progress percentage is now displayed in brackets. This provides a clear visual cue that quickly indicates your reading progress.

Setting it Up: How to Install and Use ⚙️

Ready to get started? Here's how to install and use this custom header status bar in KOReader:

Download the Patch File: First, grab the patch file. Remember to remove the .txt extension before installing it. 2-reader-header.lua.txt
Installation: Place the .lua file in your KOReader's configuration directory. The exact location may vary depending on your device, but it's typically within the KOReader folder on your device. You may need to create this folder. In many cases, it is located under the .koreader directory. Inside this directory, create a folder called reader and place the .lua file here. If you're unsure, check the KOReader documentation for your specific device.
Restart KOReader: Close and restart KOReader. This will allow the patch to be loaded and applied.
Access Settings: Go to the KOReader settings menu (usually the cog wheel icon). Navigate to the