Skip to content

Releases

KOBoard v0.6.5

Choose a tag to compare

@titandrive titandrive released this 15 Aug 22:38

Android keyboard auto-capitalization

KOBoard v0.6.5 restores automatic sentence capitalization in Android keyboards
such as Gboard.

KOBoard now identifies its editor as sentence-capable text input and reports the
capitalization mode at the current cursor position. Keyboards can therefore
capitalize the first letter of an empty field and the first letter after a
sentence boundary while continuing to respect the user's keyboard preference.

KOBoard v0.6.4

Choose a tag to compare

@titandrive titandrive released this 15 Aug 00:06

Native keyboard dialog layout fix

KOBoard v0.6.4 keeps KOReader input-dialog buttons above the Android system
keyboard.

KOBoard now measures the bottom region occupied by the active Android IME and
passes that height to KOReader's existing input-dialog layout. The measurement
uses physical display coordinates, avoiding incorrect results on fullscreen
Android devices whose application content area is shorter than the display.

The measured height is retained when KOReader recreates an input dialog, so the
layout settles after one resize without repeatedly closing and reopening the
keyboard.

This adapts automatically to screen resolution, orientation, suggestion rows,
and the height of a normally docked keyboard. Floating and split keyboards do
not reserve one continuous bottom region and are not covered by this fix.

KOBoard v0.6.3

Choose a tag to compare

@titandrive titandrive released this 27 Jul 01:10

Important updater repair

KOBoard v0.6.3 repairs a recurring failure in the plugin's self-updater.

Keyboard-session fix included

This release also includes the KOBoard input-state fix introduced in v0.6.2.
When an editor is closed, KOBoard now clears the pending Android IME input
snapshot, its comparison snapshot, and any queued backspaces. It performs the
same cleanup before opening the next keyboard session.

Previously, text or deletions left in those files could survive after closing
an editor. Reopening an editor could then repopulate an old query or apply
backspaces from the previous session after the user began typing. Each editor
now starts with clean pending-input state.

Why the updater failed

The updater bundled with v0.6.1 and v0.6.2 could terminate KOReader after
discovering a newer release. Its update-check result screen ran in an
unguarded callback, so a UI error became a fatal application error before the
new archive was downloaded. The previous installation path could also replace
files directly inside the live plugin directory, allowing a failed or partial
update to leave old and new plugin files mixed together.

What changed

  • Update checks are now guarded so an error is reported in KOReader instead of
    terminating the application.
  • The update prompt uses KOReader's standard confirmation dialog.
  • Android's system unzip command is used when KOReader does not provide an
    archive-extraction API.
  • Downloads are extracted into a temporary staging directory.
  • _meta.lua, main.lua, and koboard_updater.lua are validated before the
    installed plugin is touched.
  • The complete staged plugin is activated with a directory swap.
  • If activation fails, the previous plugin directory is restored.

Manual update required from v0.6.1 or v0.6.2

Because the defect is inside the updater that must download this repair,
affected installations cannot reliably bootstrap v0.6.3 themselves. Users
running v0.6.1 or v0.6.2 should download koboard.koplugin.zip from this
release and install it manually once.

After v0.6.3 is installed, KOBoard's updater contains the repaired,
staged-installation path and can be used for subsequent releases.

KOBoard v0.6.2

Choose a tag to compare

@titandrive titandrive released this 27 Jul 00:52

Fixes stale Android IME input snapshots carrying text or pending backspaces into a newly opened editor. KOBoard now clears pending input state when a keyboard session closes and before the next session begins.

KOBoard v0.6.1 — Text editor fixes

Choose a tag to compare

@titandrive titandrive released this 18 Jul 22:24

Fixes KOReader Text Editor not recognizing changes made through KOBoard.

Allows the Android keyboard to reopen after it has been dismissed.

Hardens the built-in updater using Syncest's protected install and archive fallback pattern, preventing installation errors from crashing KOReader.

KOBoard v0.6.0 — Android IME suggestions and synchronized editing

Choose a tag to compare

@titandrive titandrive released this 16 Jul 02:19
bb46d93

KOBoard v0.6.0 — Suggestions, autocorrection, and synchronized editing

This release significantly improves KOBoard's support for modern Android keyboards, especially Microsoft SwiftKey.

The original suggestions and autocorrection work was contributed by Gerardo Martínez (gerardomtz26). You can view view the original commits and changes here.

What's new

  • Predictive suggestions and autocorrection.
  • Android composing-text support.
  • Improved Microsoft SwiftKey compatibility.
  • Complete text and cursor synchronization between KOReader and Android.
  • Correct editing after tapping within existing text, including after reopening the keyboard.
  • Correct cursor handling around emoji and other supplementary Unicode characters.
  • More reliable input transport using atomic file snapshots.
  • Removal of development logging that recorded typed text.
  • The updater remains pointed at the official titandrive/koboard repository.

What users will see

Suggestions and autocorrections should replace the intended word without duplicating text. You can move the cursor within a field and continue typing or deleting at that location instead of being returned to the beginning or end.

Keyboard selection gestures can select and delete text, although KOReader does not currently display a visible highlight for the selected range.

Reliability

The Java-to-Lua bridge now publishes complete editor states through atomic file snapshots. This prevents a timing race that could lose characters, corrections, or cursor updates while Lua was reading and clearing the input file.

Testing

The release was compiled against Android API 34, converted to DEX, installed over ADB, and tested on a physical Android device. Testing covered typing, backspace, suggestions, autocorrection, composing text, cursor movement, reopening the keyboard, emoji, selection deletion, and rapid input.

Java compilation, Lua syntax, embedded DEX consistency, and ZIP integrity checks passed.

Known limitations

  • Android only.
  • Android selection ranges are not visibly highlighted by KOReader.
  • Keyboard-specific gestures may vary by keyboard application and version.
  • A small delay may be perceptible during rapid composing updates because KOReader polls the file bridge.

Upgrade

Install the attached koboard.koplugin.zip or use KOBoard's built-in updater, then restart KOReader. Existing settings are preserved.

Gerardo Martínez's original authored commits remain in the project history, followed by the maintainer synchronization, reliability, and packaging work.

KOBoard v0.5.0

Choose a tag to compare

@titandrive titandrive released this 06 Jul 19:15

KOBoard v0.5.0 adds a minimal in-app UI and the built-in updater.

  • Adds a KOBoard UI under Tools -> KOBoard
  • Adds an Enable KOBoard toggle in the menu
  • Shows the installed version in the menu
  • Adds manual and background GitHub release checks
  • Downloads and installs koboard.koplugin.zip, then restarts KOReader
  • Documents the new menu UI and update flow in the README

KOBoard v0.2.2

Choose a tag to compare

@titandrive titandrive released this 04 Jul 00:18

Fix accented and other UTF-8 characters being split while forwarding system keyboard input into KOReader.

v0.2.1

Choose a tag to compare

@titandrive titandrive released this 21 Jun 01:06

Fixed

  • Fixed the Android keyboard sometimes appearing when no text field was active, especially during KOReader startup or app resume.
  • Restored KOReader's normal keyboard visibility guard so repeated lifecycle calls do not reopen an already handled keyboard session.
  • Properly deactivates, defocuses, and hides KOBoard's Android editor view when the text field closes.
  • Replaced the stateful SHOW_FORCED plus toggleSoftInput sequence with a single implicit keyboard request. This prevents Android from retaining a forced keyboard state or unpredictably toggling it later.

Installation

Download koboard.koplugin.zip, extract it, and copy the koboard.koplugin directory to /sdcard/koreader/plugins/. Replace the existing directory when upgrading, then fully restart KOReader so the updated Android component is loaded.

This patch includes all text composition and backspace reliability improvements from v0.2.0.

v0.2.0

Choose a tag to compare

@titandrive titandrive released this 20 Jun 21:24

Highlights

KOBoard 0.2.0 substantially improves the reliability of text entry through Android system keyboards. This release replaces the bridge's fabricated cursor state with Android's real editable and composition state, keeping KOReader and the active IME synchronized as text changes.

Fixed

  • Removed random x insertions caused by returning a hard-coded x as the text before the cursor.
  • Prevented other stray or repeated characters from transient IME composition updates.
  • Fixed the first keystroke sometimes being ignored when an IME began a composing sequence.
  • Fixed backspace occasionally duplicating the current word instead of deleting text.
  • Improved handling of autocorrection and composing-text replacements by forwarding only the actual difference between the previous and updated text.
  • Improved deleteSurroundingText, code-point deletion, and Delete key-event handling.

Technical changes

  • Text mutations now run through Android's BaseInputConnection editable buffer.
  • KOBoard computes the common prefix and suffix around each edit, then forwards only the required deletions and inserted text to KOReader.
  • Deletion still falls back to the file bridge for text that existed before the current Android input connection was created.
  • The corrected Android component is rebuilt and embedded directly in the plugin.

Installation

Download koboard.koplugin.zip, extract it, and copy the koboard.koplugin directory to /sdcard/koreader/plugins/. Replace the existing directory when upgrading, then fully restart KOReader so the updated Android component is loaded.

KOBoard remains Android-only and experimental. Advanced IME gestures may still be limited by the file-based bridge.