Add configurable global hotkeys

[mardausdennis]

Related to #201. Builds on #297, so the first commit here is that PR. I'll rebase once it's in.

This adds global hotkeys that work while a game has focus. There are four commands: lock/unlock the overlay (pin), show/hide it, move a fixed overlay to the next monitor, and open settings. Defaults are Ctrl+Shift+H for pin and Ctrl+Shift+G for show/hide, the same letters as the unused use-keybinds.ts, which this replaces. The other two start unbound. A new Hotkeys tab lets you record a combination, clear it, and shows an error inline when another app or another command already uses it.

Bindings are stored in config.json in the shape you suggested in #201 ({ "key": ..., "command": "pin" }). Since the config still only lives in the frontend, the main window sends the bindings to a Rust command, and Rust registers them through tauri-plugin-global-shortcut. Pin and open settings run in Rust, show/hide and next monitor go back to the frontend as events.

A few choices you may want to weigh in on:

• it adds tauri-plugin-global-shortcut 2.2.0 as a Rust dependency, matching the JS package that was already in package.json
• hiding sets opacity to 0 and makes the window click-through instead of calling hide(), because show() activates the window on Windows and would pull focus out of a fullscreen game
• toggle_pin and set_pin are wrapped in hotkeys.rs under the same IPC names, so a hidden overlay stays click-through when it gets unpinned, and the tray uses the same path
• Wayland can't register global shortcuts, so the tab shows a note there and records nothing

Tested on Windows 11 by pressing the default hotkeys against the installed build with another window in the foreground. Pin and show/hide toggled, the anchored corner stayed put, and the foreground window never changed. macOS and Linux are only built by CI. The key conversion and the register/unregister logic have unit tests in hotkeys.rs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated
overlayed	Skipped		Oct 3, 2026 6:40pm UTC