Progress Bars
Add progress bars to your reading screen — inline within text regions or as full-width dedicated bars.
Inline progress bars
- Add
%barto any position line via the + Progress bar button in the line editor - Mixable with text:
%p %bar,%bar %B - Type: Chapter, Book, Book+ (top-level ticks), Book++ (top 2 level ticks)
- Styles: Border, Solid, Rounded, Metro
Full-width progress bars
- Up to 4 independent bars via Full width progress bars menu
- Anchor to any edge: Top, Bottom, Left (vertical), Right (vertical)
- Fill direction: LTR, RTL, Top-to-bottom, Bottom-to-top
- Chapter tick marks with depth-aware thickness
- Real-time margin adjustment with nudge controls
Styles
- Solid — flat fill, ticks change colour on filled/unfilled portions
- Bordered — square border with dark fill
- Rounded — pill-shaped with proper curved fill
- Metro — tube map inspired: trunk line with start ring, end dot, position marker, chapter ticks above and below
Other improvements
- Font chooser — uses KOReader's built-in FontChooser (v2026.03+) with font preview
- Smooth EPUB progress — pixel-level tracking via document position (not page-based)
- Performance — chapter tick positions cached, smart dirty tracking
Architecture
Built from scratch using a parallel data channel approach (no sentinel encoding). Progress calculations are flow-adjusted for reflowable documents.
Inspired by SH4DOWSIX's progress bar PR (#7).