nosignal/mangohud-logger-steamos
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Correct the Shift+F2 claim: the keybind does not work in Game Mode

Browse source 
The in-game keys table told users Shift+F2 toggles logging mid-game. That
holds on the desktop, where the in-game Vulkan layer is the logger, but not
in SteamOS Game Mode: there the logger is mangoapp, which ignores the
keybind. Verified under nested gamescope — the keypress produced no log at
all, while mangohudctl in the same harness started one immediately.

Document mangohudctl as the way to start/stop a log by hand in Game Mode.
It drives mangoapp over a SysV message queue, so it needs no display, no
Wayland socket and no window focus.
This commit is contained in:
28allday 2026-07-31 19:09:52 +01:00
parent 551471f0b3
commit d2f70296f5
1 changed files with 12 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
README.md
View file

@ -203,9 +203,20 @@ In-game keys (set by the script's MangoHud block):
| Key | Action | | Key | Action |
|---|---| |---|---|
| `Shift+F2` | Toggle logging on/off mid-game | | `Shift+F2` | Toggle logging on/off mid-game — **desktop only, see below** |
| Your existing `toggle_hud` key | Hide the HUD overlay (logging keeps running) | | Your existing `toggle_hud` key | Hide the HUD overlay (logging keeps running) |
> **`Shift+F2` does not work in SteamOS Game Mode.** There the logger is
> mangoapp, not the in-game Vulkan layer, and mangoapp ignores the keybind.
> Verified under nested gamescope: the keypress produced no log at all. To
> start/stop a log by hand in Game Mode, use `mangohudctl` (ships with MangoHud),
> which drives mangoapp over a message queue and needs no display or focus:
>
> ```bash
> mangohudctl set log_session true # start
> mangohudctl set log_session false # stop (also writes a _summary.csv)
> ```
CSV files appear in `~/Downloads/mango-logs/`. Drop them into CSV files appear in `~/Downloads/mango-logs/`. Drop them into
<https://flightlessmango.com/> for graphs, or open in a spreadsheet. <https://flightlessmango.com/> for graphs, or open in a spreadsheet.