Releases from this project are meant only as records of major changes. There will be automatic attachments generated by GitHub, but to get the latest version download the zip from the green <> Code ▼ button on the main page, or use the quick-install one-liner command.
Changes
This release covers roughly March through early May 2026.
New distro support
- Add support for NebiOS (Ubuntu-based,
nebiosdistro ID), with detection of the NebiDE desktop environment via Wayfire config file path, and a NebiDE-specific keymap
New features and improvements
- Default config overlays^ — group-level enable/disable for sets of default-config keymaps, with a new submenu in the tray indicator icon menu and a GTK4 dialog for managing overlay state at runtime
toshy-libinputcommand for inspecting libinput devices and managing the Toshy DWT quirk^^, with installer integration that prompts for reboot when the quirk is freshly installedtoshy-xkb-checkcommand and module — detects XKB option choices that break Toshy's virtual Cmd key^^^, including a check of the KDE Plasma XKB rc file in addition to live session settings- XKB check integrated into the default config — surfaces a warning at startup when a conflicting XKB option is active so users aren't left wondering why shortcuts don't work
- Pre-check infrastructure for
matchProps— frequent context conditions (keyboard-type checks, overlay state) are evaluated once per event into booleans rather than re-evaluated inside every per-keymap closure, reducing redundant work on hot paths - Flatten functions and remove lambda wrappers in default config (continuation of the performance refactor started in v26.03.0)
- Prevent SIGINT from Cmd+C in terminals (Ptyxis, Konsole) when no text is selected, by routing Cmd+C to a non-SIGINT shortcut in those apps
- Cmd+Q remap for Brave browser — works once the user assigns the shortcut inside Brave's keybind settings (Brave does not bind one by default)
- Dolphin Cmd+W now correctly handles the settings dialog
Fixes
- Detect bad locale settings and sanitize Unicode strings when the locale cannot be repaired, with a diagnostic dialog explaining the situation
- Adapt to Deskflow process consolidation in v1.24+ (single
deskflow-corebinary replaces the priordeskflow-server/deskflow-clientsplit) - Improvements for Chimera Linux: BSD
sedincompatibility in setup, AppIndicator quirks handler, and prompting the user to runapk update && apk upgradebefore install - Catch fresh install of the libinput DWT quirk so the post-install reboot is not skipped, and start the service with the DWT flag in the correct state
- Better error message when
libinput quirks installfails - Detect Zorin OS 18 appindicator extension UUID
- Adapt to missing
systemd1service name on some configurations - Prevent a file error when checking desktop environment versions
- Improve the wlroots-dbus service exit log message
- Convert remaining
isKBtypeconditional callables to booleans (correctness + perf) - Fix typo in install flag parsing
Installer/setup tweaks
- Prompt for reboot when the libinput quirk was just installed, instead of bypassing the post-install reboot notice
- Add
libinput-tools(and related utilities) to more package lists across distros - Enhance attention-grabbing on bail/error messages during install
- Add
toshy-perf-testscript for internal config-performance measurement
^ The overlays system lets users selectively disable groups of keymaps from the default config without editing the file. Each overlay is tracked in settings and can be toggled from the "Overlays" submenu in the tray indicator icon's menu, or a GTK4 dialog in the Toshy Preferences app, making it easy to turn off, e.g., browser-specific or terminal-specific keymap blocks when they conflict with the user's workflow.
^^ DWT (Disable While Typing) is a libinput feature that ignores touchpad input while the user is typing. The toshy-libinput command makes it straightforward to install/remove the Toshy DWT quirk, list devices, and inspect libinput state without hand-editing system files under /etc/libinput/.
^^^ XKB options like compose:rctrl redefine Right Ctrl in ways that break Toshy's virtual Cmd key, which is mapped to RIGHT_CTRL. The check identifies these conflicts at startup — including the case on KDE Plasma where the option is set in the rc file but not yet reflected in the live session — and warns the user before they hit confusing shortcut breakage.
Auto-generated full release notes (click to expand):
What's Changed
- Update note on minimum xwaykeyz version by @RedBearAK in #789
- Update supported package managers list by @RedBearAK in #790
- Fix Cmd+Q in Brave browser (manual activation req) by @RedBearAK in #792
- Version bump default config file by @RedBearAK in #793
- Adaptations to support NebiOS by @RedBearAK in #794
- Fix or adapt to bad locales with diagnostic dlg by @RedBearAK in #795
- Detect NebiDE, add keymap by @RedBearAK in #796
- Add note about NebiOS support by @RedBearAK in #797
- Fix Deskflow support, add toshy-libinput cmd by @RedBearAK in #803
- Install libinput quirk with tester script by @RedBearAK in #804
- Prompt for reboot if libinput quirk was installed by @RedBearAK in #805
- XKB check tool, config checks XKB issues by @RedBearAK in #808
- Check XKB RC file in KDE Plasma by @RedBearAK in #809
- Update devices_api example block/comments by @RedBearAK in #811
- Prevent SIGINT from Cmd+C without text selection by @RedBearAK in #815
- Detect Zorin OS 18 appindicator extension by @RedBearAK in #817
- Handle reboot flag when libinput quirk installed by @RedBearAK in #818
- Improve wlroots service exit log message by @RedBearAK in #819
- Config optimizations, pre-checks by @RedBearAK in #821
- Libinput quirks fix by @RedBearAK in #823
- Overlays, Chimera fixes, Dolphin dialog by @RedBearAK in #825
- Fix typo in install flag parsing by @RedBearAK in #826
- Update comments on xwaykeyz, python-xlib by @RedBearAK in #827
Full Changelog: Toshy_v26.03.0...Toshy_v26.05.0