OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
wayland-compat medium common DISPUTE

Make OBS hotkeys fire while another window is focused

omarchyarchendeavouroscachyosmanjarohyprlandwayland
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

Cause is right and the plugin is real: obs-wayland-hotkeys-git exists in the AUR (maintainer MonterraByte, upstream leia-uwu/obs-wayland-hotkeys, 'OBS Studio plugin that implements the global shortcuts portal'), and XDPH does implement org.freedesktop.impl.portal.GlobalShortcuts. The websocket alternative is broken as written: obs-cmd toggle-record is not a valid invocation. obs-cmd's CLI is noun-then-verb: the recording commands are obs-cmd recording start|stop|toggle|pause|resume|status. The record also never tells the user to install obs-cmd (AUR only, not in the official repos), and the Lua bind uses "SUPER SHIFT + R" where the 0.55+ syntax joins every modifier with + ("SUPER + SHIFT + R"), so the bind would not parse.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.

Symptom

OBS start/stop recording and scene-switch hotkeys only fire when the OBS window itself is focused. Press them while gaming or in a browser and nothing happens.

Cause

Wayland gives no client the ability to grab keys globally. That requires the GlobalShortcuts portal, which OBS does not implement (obsproject/obs-studio issue 10538). OBS's hotkey system falls back to focused-window input only.

Fix

Install the plugin that wires OBS into the XDG GlobalShortcuts portal:


yay -S obs-wayland-hotkeys-git

Restart OBS. It will prompt to register global shortcuts on next launch (xdg-desktop-portal-hyprland implements org.freedesktop.impl.portal.GlobalShortcuts, so the prompt is handled).

Alternative without a plugin: bind the keys in Hyprland and drive OBS over its websocket. Enable Tools -> WebSocket Server Settings in OBS, note the port and password, then install the client (AUR only):


yay -S obs-cmd

The command is noun-then-verb: obs-cmd recording toggle, not obs-cmd toggle-record. If you set a websocket password, pass it with --websocket obsws://localhost:4455/<password> or export OBS_WEBSOCKET_URL.

Hyprland <=0.54 / Omarchy 3.x (~/.config/hypr/bindings.conf):


bind = SUPER SHIFT, R, exec, obs-cmd recording toggle

Hyprland 0.55+ / Omarchy 4.x (~/.config/hypr/bindings.lua). Note every modifier is joined with + :


hl.bind("SUPER + SHIFT + R", hl.dsp.exec_cmd("obs-cmd recording toggle"))

Verify it before trusting the keybind:


obs-cmd recording status

Verify

Focus another window, press the hotkey, and OBS's recording indicator changes state.

Sources

obs-global-hotkeys-dont-work