hex/docs/releases/linux-wayland-beta.md
Dax Raad 1577c19b52 feat(linux): portal shortcuts and hex commands replace raw Wayland input
Wayland shortcuts no longer read /dev/input. One state machine in
linux_input now serves every source:

- X11: the existing key grabs, with auto-repeat filtering split out and
  tested, and the inline gesture flags replaced by the shared rules.
- Wayland with the GlobalShortcuts portal: Register("hex"), one session for
  dictation, Paste Last, and Voice Action, and a second session that binds
  Escape (also with the held shortcut's modifiers) only while recording.
  Activated/Deactivated are press/release; refused shortcuts and the
  trigger the desktop actually granted show in Settings; a closed session
  cancels and stops the listener with an error.
- Everywhere: `hex dictation start|stop|toggle|cancel`,
  `hex voice-action start|stop|toggle`, and `hex paste-last` talk to the
  running service over its socket for desktops without the portal. They
  are idempotent, never start the service, and fail clearly when it is
  missing or not listening.

Settings records shortcuts from its own key events on Wayland too, lists
the granted triggers, or, without the portal, hides the shortcut rows and
lists the commands. Wayland paste no longer waits for held modifiers:
wtype's virtual keyboard sends its own, and the Wayland paste smoke now
pastes while another keyboard holds Ctrl and Alt.

Removes linux_wayland_input.rs, the evdev and udev crates, libudev-dev in
CI, and every input-group requirement from the docs. Also gates
AppWindowPreview::pane to macOS, whose only callers broke the Linux
Clippy build.
2026-10-22 01:13:07 -04:00

1.2 KiB

Linux Wayland And Nix Beta

Unreleased. Physical input, microphone, and supported-host validation remain release gates; passing container tests alone does not establish those behaviors.

  • Add native Wayland dictation on compatible wlroots compositors, with a click-through recording/processing indicator. Shortcuts come from the desktop's GlobalShortcuts portal, and Settings shows what it granted; without the portal, bind hex dictation start|stop|toggle|cancel, hex voice-action start|stop|toggle, and hex paste-last in the compositor. No input-device access or input group is needed.
  • Keep shortcut changes, cancellation, and tray-less listener recovery manageable from Settings.
  • Cancelling a new capture keeps older pending transcription visible in Settings.
  • Add Nix packaging and a matching development shell, plus optional per-user Home Manager autostart. Nix installations leave updates to Nix.

The beta builds on the proposals in #28 and #29. It does not claim GNOME or KDE support and reads no input devices. See ../linux.md and ../nix.md for the supported setup.