Translator Preview v1.0.1

Changelog

• Added Translator Preview, a compact alternative to KOReader’s default translator popup.
• Added support for two preview layouts:
  • Bottom panel;
  • Floating preview card.
• Added a cleaner translation header showing the language pair, for example: English → Portuguese ▾.
• Made the language pair header clickable, allowing the target language to be changed directly from the preview.
• Added a fixed separator between the language header and the translated text, keeping the header visually separated even when the translation text is scrolled.
• Improved spacing between translated text and action buttons to avoid cutting descenders in letters such as g, p, q and ç.
• Reduced header and button typography for a more compact visual style.
• Added action buttons for:
  • Copying the translated text;
  • Saving the translation as a note when used from a highlight;
  • Opening KOReader’s original detailed translator view.
• Replaced the verbose details button with a compact ••• action.
• Added a Buttons submenu in the plugin settings to group button-related options.
• Added settings for:
  • Enabling/disabling the preview;
  • Enabling floating preview mode;
  • Showing/hiding source text;
  • Showing/hiding the copy button;
  • Showing/hiding the note button.
• Added a version entry in the settings menu.
• Included internal cleanup and small performance improvements around popup handling, layout calculation, and translation result processing.

Documentation

translatorpreview.koplugin.md

Assets

• translatorpreview.koplugin-v1.0.1.zip

Selection Toolbar v1.0.0

First stable release of Selection Toolbar, a KOReader plugin that replaces the default centered text-selection menu with a compact icon toolbar displayed near the selected text.

Changelog

• Added a compact horizontal toolbar for text-selection actions.

• Replaced the default two-column centered selection menu.

• Added smart positioning near the selected text, below the selection when possible and above it when needed.

• Preserved KOReader’s native ReaderHighlight behavior by reusing the original action callbacks.

• Added support for enabling or disabling individual toolbar actions.

• Added direct icon loading from the plugin’s own icons/ folder.

• Added a version entry in the plugin settings menu: v1.0.0.

• Added QR Code generation using KOReader’s native ui/widget/qrmessage widget when available.

• Improved compatibility with other plugins by making the IconWidget patch only handle explicitly provided icon paths.

• Added small performance and organization improvements:

  • cached icon paths;
  • cached QR Code widget loading;
  • reduced repeated action-settings reads;
  • optimized page-offset calculation for toolbar positioning;
  • centralized toolbar button sizing and padding logic.

Available actions

• Select
• Highlight
• Copy
• Add note
• Wikipedia
• Dictionary
• Translate
• View HTML
• Generate QR code
• Search

Configuration

The plugin can be configured from:

Settings > Selection toolbar

Available options:

• Use compact selection toolbar
• Visible actions
• Show all actions
• Version: v1.0.0

Assets

Attach the plugin archive to this release:

selectiontoolbar.koplugin.zip

After downloading, extract or copy the folder:

selectiontoolbar.koplugin/

to KOReader’s plugins directory:

koreader/plugins/

On Kindle devices, the path may be:

/extensions/koreader/plugins/

Restart KOReader after installation.

Notes

• View HTML is shown only when the original KOReader action is available for the current document.
• Generate QR code requires KOReader’s native ui/widget/qrmessage widget.
• On narrow screens, the toolbar may use most of the available width when all actions are enabled.
• Disabling Use compact selection toolbar restores KOReader’s default selection menu.

Reader Header Footer v1.0.1

Changelog

• Added a new version indicator to the plugin settings menu.
• The settings menu now includes an option to view the current plugin version.
• Current version displayed: v1.0.1.
• This update makes it easier to confirm the installed plugin version directly from KOReader.

Dictionary Preview v1.1.1

Changelog

• Added a new version indicator to the plugin settings menu.
• The settings menu now includes an option to view the current plugin version.
• Current version displayed: v1.1.1.
• This update improves plugin identification and makes it easier to confirm the installed version directly from KOReader.

Dictionary Preview v1.1.0

This release adds a new optional floating preview mode to Dictionary Preview, alongside several layout, usability, and performance improvements.

The plugin can now display dictionary definitions either in the original bottom preview panel or in a compact floating card. The floating card automatically chooses whether to appear near the top or bottom of the screen to avoid covering the selected word, while preserving the same flexible height behavior used by the standard preview.

Highlights

• Added optional Floating preview mode.

• Added smart floating-card positioning to avoid overlapping the selected word.

• Preserved adaptive height behavior in both bottom and floating preview modes.

• Added a minimum compact height to avoid unnecessary scrolling in short one-sentence definitions.

• Improved preview title layout:

  • selected word shown prominently;
  • dictionary name shown below in smaller italic text;
  • dictionary result count shown when multiple results are available.

• Kept the original preview button behavior:

  • configurable left action;
  • previous/next dictionary buttons when multiple results are available;
  • right button to open KOReader’s standard dictionary popup.

• Improved handling of multiple dictionary results by focusing navigation on useful definitions.

• Cleaned up and reorganized the code for easier maintenance.

• Added small performance improvements by caching repeated values and reducing unnecessary recalculations.

Settings

This release keeps the existing settings and adds a new one:

dictionarypreview_floating_preview

The new option can be toggled from:

Dictionary preview → Floating preview

Upgrade notes

Replace the existing dictionarypreview.koplugin files with the new version and restart KOReader.

The standard bottom preview remains the default behavior. Floating preview mode must be enabled manually from the plugin menu.

Reader Header Footer v1.0.0

Reader Header Footer v1.0.0

Initial release of Reader Header Footer, a KOReader plugin that adds discreet reading information to the page margins while reading.

This version displays useful indicators directly on the reader screen without adding extra bars or changing the main reading interface. It shows contextual book information, Wi-Fi/time/battery status, pages left, and reading progress, while using regional refreshes to avoid unnecessary full-screen redraws.

Highlights

• Added top-left contextual information: chapter title or author + book title.
• Added top-right indicators: Wi-Fi, time, and battery.
• Added bottom-left reading information: pages left in chapter or book.
• Added bottom-right document reading percentage.
• Added plugin menu to enable/disable indicators.
• Added configurable bottom-left mode.
• Added configurable font size.
• Added automatic or manual margin alignment.
• Added regional refreshes to reduce flickering and avoid full-page updates.
• Added deferred refresh protection while KOReader menus or dialogs are open.

Install by copying reader_header_footer.koplugin to your KOReader plugins folder and restarting KOReader.

PlainUI Custom v1.0.0

Initial release of Plain UI Custom, a KOReader plugin that enhances the File Manager with a more library-oriented interface.

This version adds navigation tabs for Files, Series, Authors, and Tags, allowing books to be browsed through virtual metadata-based views without changing the actual file structure. It also includes per-view filtering and sorting, metadata facet navigation, and visual improvements for the File Manager header, footer, covers, and list entries.

Highlights

• Added metadata navigation tabs: Files, Series, Authors, and Tags.
• Added virtual browsing by author, series, and tag.
• Added reading status filters for supported views.
• Added per-tab sorting options.
• Added facet-based refinement for metadata groups.
• Added visual indicators such as reading percentage and finished-book badges.
• Customized the File Manager header and footer layout.

Install by copying plainui-custom.koplugin to your KOReader plugins folder and restarting KOReader.

Dictionary Preview v1.0.0

Initial release of Dictionary Preview, a KOReader plugin that improves the dictionary lookup flow by showing a compact preview panel before opening the full dictionary popup.

This version displays dictionary definitions in a bottom preview panel, preserves dictionary formatting when available, supports adaptive panel height for short definitions, and allows quick actions such as opening the original dictionary popup, searching the selected term in the book, highlighting the selection, or looking it up on Wikipedia.

Highlights

• Added compact bottom-panel dictionary preview.
• Preserved dictionary HTML/CSS formatting when available.
• Added adaptive panel height for short definitions.
• Added navigation between multiple dictionary results.
• Hidden previous/next buttons when there is only one useful result.
• Added configurable left-button action: Highlight, Fulltext search, or Wikipedia.
• Added optional custom icons for Highlight and Wikipedia.
• Added gesture support: swipe left/right to change dictionary result, swipe down to close.
• Prevented nested preview panels while the original KOReader dictionary popup is open.

Install by copying dictionarypreview.koplugin to your KOReader plugins folder and restarting KOReader.