y3owk1n/neru v1.62.0

on GitHub

1.62.0 (2026-11-08)

This release lets the key that finishes a hint label choose what the selection does. Hold a modifier on that last key to right-click, open a link in a new tab, or copy the hint's text with the new copy_text action. Grid gets --no-subgrid for one-step jumps, and hints that read the screen now work on a window that runs past the screen edge.

Migration Guide

Pick an action with the last key

• [hints.select_with] maps a set of held modifiers to steps that run in place of the session's --action when you finish a label with those modifiers held
• Keys are cmd, ctrl, alt, shift and primary, joined with +, and match only when exactly those are held. Values are steps written as in a hotkey binding, so actions, macros, exec and mode commands all work
• action session_action runs the session's own --action at the cursor. Paired with idle, it finishes a --repeat session in one key instead of a label plus Escape
• After an entry runs, the session ends the way its --action would. A --repeat session, or one opened without --action, reopens hints. Any other session exits and runs --on-exit
• Per-app entries go under [[hints.app_configs]] select_with, and "__disabled__" removes one
• A set whose chord with a hint character is already bound is refused at load, since the binding would answer first. With the default bindings that rules out shift, because Shift+L is bound and l is a hint character. neru config validate names the binding to move
• Linux: a held Shift turns a symbol hint character into its shifted symbol, so shift entries need letter hint characters

[hints.select_with]
ctrl = ["action session_action", "idle"]   # the session's action, then exit
alt = "action right_click"
cmd = "action left_click --modifier cmd"   # open a link in a new tab

Copy a hint's text

• copy_text copies the selected hint's text to the clipboard. Use hints --action copy_text to copy the hint you type without clicking it, or use it as a step in a select_with entry or an --on-exit
• It copies the element's value, else its title, else its description. That is a field's contents, a button's or link's name, or the words the vision strategy read
• A password field's text is never copied
• macOS: while hints mode is open, copy_text reads the hint's own box again at several sizes and keeps the answer most reads agree on, so small UI text copies correctly. contour and segment hints, which carry no text, now copy the text in their box too
• Linux and Windows: contour and segment hints carry no text, so copying one fails and leaves the clipboard alone
• Linux: needs wl-copy on Wayland, or xclip or xsel on X11. neru doctor reports the new clipboard capability

[hotkeys]
"Primary+Shift+Y" = "hints --action copy_text"

[hints.select_with]
"ctrl+alt" = ["action copy_text", "idle"]   # copy the hint's text, then exit

Grid without the subgrid

• grid --no-subgrid selects a cell's center on the last key of its label, instead of opening the 3x3 subgrid
• With an action, it runs at once and the mode exits, so grid --no-subgrid --action move_mouse saves a key on every jump
• Without an action, the mode stays open with the cell highlighted. Backspace and reset edit the label, and a snap searches only that cell
• --repeat keeps the flag on every round. Plain grid is unchanged

[hotkeys]
"Primary+Shift+G" = "grid"
"Primary+Shift+F" = "grid --no-subgrid --action move_mouse"

Fixes

• Hints with vision, contour or segment work on a window that runs past the screen edge, even by one pixel. On Linux a maximized window inside a window manager's 1px frame got no hints at all. Hints now scan only the part of the window a screen shows
• A vision, contour or segment snap asks for screen recording first. It now opens Neru's permission alert, whose Request Permission button clears the stale entry an upgrade leaves in System Settings. It used to let macOS show its own prompt and keep the stale entry. On KDE Plasma it asks for the portal screen-sharing consent instead of failing
• Linux: X11 global hotkeys on symbol keys such as "Super+;", "Super+-" and "Super+Shift+:" now register. They passed neru config validate and then failed at launch

Features

• grid: add --no-subgrid flag to select a cell without the subgrid (#1927) (c044540)
• hints: copy a hint's text to the clipboard with copy_text (#1917) (cb101a8)
• hints: pick a hint's action by the modifiers held on its last key (#1915) (b1405e2)

Bug Fixes

• hints,darwin: make copy text via vision more accurate (#1918) (31acf29)
• hints: show hints for a window that runs past the screen edge (#1928) (a64a277)
• linux: let X11 global hotkeys use symbol keys (#1920) (2871d96)
• snap: ask for screen recording before a capture-strategy snap (#1926) (6a50136)