From 76de7734c1eac39b467f452038cd7f2cba8fbd08 Mon Sep 17 00:00:00 2001 From: Pierre Kisters <1524059+lhns@users.noreply.github.com> Date: Thu, 1 Oct 2026 04:07:27 +0200 Subject: [PATCH] VR keyboard extra keys: docs: the helper's debug variables, one place for the other-keymaps note VRKBD_VERBOSE and VRKBD_DISPLAY were undocumented; the extra keys section gets a Debugging line like the others. That the routing is harmless on other keymaps was said twice; now once, under Layouts. --- docs/keyboard.md | 10 +++++++--- modules/vr-keyboard-extra-keys/xdotool-helper.mjs | 1 + 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/docs/keyboard.md b/docs/keyboard.md index ce84360..5722f53 100644 --- a/docs/keyboard.md +++ b/docs/keyboard.md @@ -48,7 +48,8 @@ Applies right away: no reboot or Steam restart needed, and it is re-applied after Steam restarts. Turning it off reverts the keyboard. **Layouts:** the character routing targets the German keymap; on others it -is harmless, and Esc/Ctrl/Alt/arrows work regardless. +is harmless (xdotool types those characters on any keymap), and +Esc/Ctrl/Alt/arrows work regardless. **Security:** the helper service that presses the keys only accepts single-key Ctrl/Alt chords, the extra keys (and F1–F12 for @@ -78,13 +79,16 @@ Steam client 1790377368 (UI build 11041156). keymap. - Problem characters (non-ASCII, AltGr/dead-key characters on the German keymap) are typed with `xdotool type`; everything else goes through - Steam's own text emulation. On other keymaps those characters are still - typed by xdotool, which is why the routing is harmless there. + Steam's own text emulation. - The new keys use Steam's key type Meta (the dark face); the Delete key takes Backspace's key type. - Found by signature (see [finders and signatures](ui-patches.md#finders-and-signatures)). +**Debugging:** `journalctl --user -u steam-keyboard-patch` (injection +results, rejected key requests, xdotool errors); `VRKBD_VERBOSE=1` in the +service's environment logs every injection, `VRKBD_DISPLAY` replaces `:0`. + ## Swipe and suggestions `keyboard.vr.*`, module `vr-keyboard`. diff --git a/modules/vr-keyboard-extra-keys/xdotool-helper.mjs b/modules/vr-keyboard-extra-keys/xdotool-helper.mjs index 26ab4e4..dc1e982 100644 --- a/modules/vr-keyboard-extra-keys/xdotool-helper.mjs +++ b/modules/vr-keyboard-extra-keys/xdotool-helper.mjs @@ -6,6 +6,7 @@ // On SIGTERM/SIGINT it reverts the patch (unpatch.js), so stopping the service // restores Steam's stock keyboard without restarting Steam. // usage: node xdotool-helper.mjs [xdotool] +// Debugging (docs/keyboard.md): VRKBD_VERBOSE=1, VRKBD_DISPLAY. import { readFileSync } from 'node:fs'; import { execFile } from 'node:child_process'; import { allowedCombo, allowedChar, allowedMod } from './allowlist.mjs';