Skip to content

Craftwork2720/koreader-patches

Repository files navigation

KOReader User Patches


2-exclude-folders — Exclude folders and files from History and Statistics

Prevents selected folders or files from appearing in Reading History or being tracked by Reading Statistics. Settings are saved automatically — no manual file editing required.

Adding exclusions

Method How
Long-press a folder or file in File Manager Buttons appear at the bottom of the context menu
Tools → Exclude Folders & Files Full list view — add paths manually or remove existing entries
Tools → Exclude this book… Available inside the reader — excludes the currently open book

How matching works

  • Folders — partial match: "Manga" excludes everything under any path containing that word
  • Files — exact match: only that specific file is excluded
  • Matching is case-sensitive

Behavior

  • History — excluded entries are removed the next time you open the History view
  • Statistics — excluded files are ignored after the book is reopened
  • If a file is inside an already-excluded folder, its button will be greyed out — the exclusion is inherited from the parent folder and cannot be removed directly


2-incognito — Open a book without leaving any trace

Opens a file in incognito mode — nothing from the session is saved.

Long-press a file in File Manager → Open Incognito appears at the bottom of the context menu.

When you open a book via Open Incognito:

  • no history
  • no statistics
  • no progress saved
  • no document settings saved or modified
  • no highlights or notes saved or modified
  • no .sdr sidecar folders created or modified

Prefer a plugin? Download incognito.koplugin. Identical functionality, with an icon displayed when saves are blocked.

Download incognito.koplugin.zip



2-hide-status-bar — Hide status bar ( 3 actions + auto-hide in night mode )

Hides the entire status bar (footer + alt status bar for CRE documents), with auto-hide support in night mode.

Controls

Type Action Behavior
Menu Reader: Config → Status bar → Hide status bar Toggle — persisted, restored on next open
Menu Reader: Config → Status bar → Hide status bar in night mode Auto-hide when night mode is active
Gesture / Profile Reader → Hide status bar One-way: hide (not persisted)
Gesture / Profile Reader → Show status bar One-way: show (not persisted)
Gesture / Profile Reader → Toggle status bar visibility Toggle — persisted

Behavior

  • State is persisted across book sessions
  • For CRE documents (e-ink text rendering), also hides the alt status bar at the top
  • Hide / Show actions do not persist state — intended for temporary control (gestures, profiles)
  • Menu options are only available while a book is open


2-physical-page-count — Match page numbers to a physical edition

Adds a Physical page count option. Enter the number of pages in the physical book and KOReader automatically calculates the correct characters-per-page value so the page counter matches the printed edition.

In-book top menu → Navigation → Physical page count… Opens the input dialog



2-filemanager-title-hide — Hide "KOReader" title

Removes the large title from the File Manager without leaving empty space behind. The current path subtitle remains visible.



Adds horizontal padding to the file path shown in the File Manager title bar — useful when it overlaps with buttons.

Note

The back arrow button comes from a separate patch by sebdelsol: 2-browser-up-folder.lua



1-gettext-translate — Custom translations for patches and plugins

Lets you add translations for any string in a community patch or plugin — without modifying any official KOReader files.

Setup:

  1. Set your language at the top of the file:
local LANGUAGE = "pl"  -- "pl" = Polish, "de" = German, "fr" = French, "es" = Spanish
  1. Add your translations to the translations table:
["My English string"] = "Mój polski string",

Note

This only works for strings explicitly wrapped in _("..."). Official KOReader translations are never overwritten.

About

KOReader User Patches

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages