RedBearAK/Toshy Toshy_v26.06.0

Toshy v26.06.0

on GitHub

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 mid-May through mid-June 2026.

Note: Some capabilities in this release depend on the matching xwaykeyz release, which provides the keymapper-side layout-correction support, the Level 3 Shift mapping, the related config APIs, a hardware quirk for the T2 Mac Touch Bar Fn key, and full touchpad support in suspend/resume logic. A fresh Toshy install pulls the required xwaykeyz version automatically.

Existing users: The keyboard layout correction API call lives in an editable section of the config (keymapper_api). Reinstalling Toshy splices your existing editable slices into the new default config to preserve your customizations, which means a new API call like this one will not magically appear on its own, even after reinstalling. To try it, add the following to that section of your config manually, then restart Toshy with the toshy-services-restart command (or the restart item in the tray indicator menu) so the edited config is reloaded:

# Requires xwaykeyz v1.18.0 or later
try:
    keyboard_layout_correction(
        enabled             = True,
        correct_number_row  = False,
    )
except NameError:
    pass

The try/except NameError guard keeps the config working even if the running keymapper predates the API. Which shouldn't happen.

New features and improvements

• Non-US keyboard layout correction^ (off by default). Toshy can now detect the active XKB layout (and layout switching events) and correct the keymapper's US-positional keycode remapping rules so they fire on the correct physical keys for non-US layouts. This is a basic first pass that works in the most common desktop environments. A new kblayout_detect package provides priority-ranked backends for GNOME, KDE, Cinnamon, COSMIC, and a generic Wayland fallback, plus an X11/Xorg backend that covers any possible window manager or desktop environment running in an X11/Xorg session. The KeyboardLayoutAnalyzer builds the key-to-key correction map at startup or layout switch, and kblayout_setup wires it into the default config and the keymapper.
• toshy-kblayout-check command and module, for testing whether Toshy can detect the active layout and layout switching, including a dedicated test script for Sway/wlroots sessions.
• Level 3 Shift from the left Option position^^ (on by default, controlled by an overlay flag). The left-side Option key can now act as a Level 3 shift for the alphanumeric and punctuation block, giving access to any level 3/4 characters on layouts that have such layers, from the Option key position on both sides, in imitation of macOS special characters. (For use with layouts like the US English "Macintosh, ANSI" variant, or any layout in any language that has a Level 3 Shift key on the layout, and extra characters beyond the basic Shift layer.)
• Alt_Gr on the Menu key (on by default). Maps the PC-laptop context-menu key to Right Alt, enabling a clean virtual right Cmd on laptops where the modifier rotation would otherwise not have a right-side virtualized Option/Alt key position. (Right-side Alt key on PC keyboards is typically turned into another virtualized Cmd key.)
• Optional Super/Meta tap pass-through (off by default). Lets a bare Meta/Super tap fall through on the Option or Cmd positions instead of being consumed. Useful for desktop environments where you still want a tap of the usual Meta key position to still activate an app launcher, app menu or overview UI, even with Toshy's Mac-like scheme in operation. (GNOME users may still need to re-enable the overlay-key shortcut in the terminal.)
• Process launcher that prevents zombie processes. Replaces the prior signal-based child reaping with an explicit launcher, fixing interaction with the GLib event loop on newer distros.
• Distro-group tweak maps. Package and quirk tweaks can now target whole distro groups rather than being repeated per distro, and package/distro ID lists were flattened for easier maintenance.
• Updated JetBrains keymap style, and fixed some JetBrains remaps.
• Mac startup sound (boot chime) volume script made more user-friendly, with more consistent output info.
• One-liner quick-install link added to the top of the README.
• toshy-versions now reports versions for the overlay_context and kblayout_setup modules and the kblayout_detect package and its sub-modules, if called with --all option.

GUI and tray menu

• The Preferences app and the tray indicator menu's Preferences submenu now expose controls for the new options. Added a toggle for Alt_Gr on the Menu key, and a new "Super Tap Passthru" group with switches for making the left Option and left Command positions act as Super/Meta when tapped (and their normal key when held or used in a combo).

Fixes

• Remove SIGCHLD=SIG_IGN that broke the GLib event loop on newer distros. Community PR from @AhmedShaalan
• Arch quirks handler for the libinput-tools package split.
• Fix Chimera package list (remove libinput-tools).
• Add the Wayland dev package to more distro package lists.
• Keep diagnostic dialog text out of the journal, and indent it in the terminal for readability.

^ Shortcut rules in the default config are written against US key positions. On a non-US physical layout, the key at a given position differs, so those rules would otherwise fire on the wrong keys. It is off by default while the feature matures. The detection backends are priority-ranked. A desktop-environment-specific backend (GNOME, KDE, Cinnamon, COSMIC) is preferred when available, falling back to a generic Wayland backend, then X11, which keeps detection accurate across the desktop environments Toshy supports without assuming any single mechanism is present. The analyzer turns the detected layout into a key-to-key correction map that the keymapper applies on the hot path.

^^ This generates Left Alt → Right Alt combo rewrites for the alphanumeric and punctuation block, so holding the left Option key reaches the Alt_Gr (which is Level 3 Shift on some layouts) layer. It is on by default and can be toggled through the overlay flag system.