omp-docs/tools/niri/key-bindings-syntax.md

@@ -45,13 +45,19 @@ binds {
 
 ## Finding Key Names
 
-Use [`wev`](https://git.sr.ht/~sircmpwn/wev) to find XKB key names:
+Niri binds by XKB **keysym name**, and the authoritative list is already on the box — no
+tool needed:
 
 ```bash
-wev
-# Then press the key you want to bind — look at `sym: XXXX` in output
+grep -oE 'XKB_KEY_[A-Za-z0-9_]+' /usr/include/xkbcommon/xkbcommon-keysyms.h \
+  | sed 's/^XKB_KEY_//' | grep -ixE 'a|return|left|tab|escape'
 ```
 
+To read the keysym off a key you actually press, use
+[`wev`](https://git.sr.ht/~sircmpwn/wev), the Wayland equivalent of `xev`. It is NOT in the
+enabled repositories — checked 2026-10-21, `pacman -Ss --sync wev` returns nothing — and the
+AUR builds it as `wev-git` (`yay -S wev-git`; `aur/wev-git 1.1.0.r1.gb09b664-1`).
+
 Shifted keys require Shift + the unshifted key (for example, `Mod+Shift+Comma` for `<` on US QWERTY).
 
 ## Constraints

omp-docs/tools/niri/screenshots.md

@@ -32,7 +32,7 @@ Noctalia settings lives on `Mod+Shift+O` (moved off Mod+Shift+S).
 
 - Portal chain: flameshot 14 → `xdg-desktop-portal-gnome` → niri D-Bus
   API → `screenshot_all_outputs` → `ensure!(outputs.len() == 1)`
-  (FIXME upstream).
+  (an upstream defect, still unfixed — issue links below).
 - `flameshot full` on 2 outputs: each press emits **3 refusals**
   (composited screen + per-output) — `WARN niri::niri: error taking a
   screenshot: Condition failed: outputs.len() == 1 (2 vs 1)` in