From 343c2ef68b1bcffdc63012217f70ebeb06c2569e Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 3 Sep 2026 06:15:59 +0000 Subject: [PATCH 1/2] Fix wrong return-to-launcher hotkey; document Cemu controller/audio setup MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The README's "Return to launcher: Ctrl+Alt+Shift+W or START+UP+RB" was wrong on both counts — confirmed live the controller combo did nothing. The real, standard Moonlight client shortcuts (confirmed against Moonlight's own documented shortcuts, not Wolf-specific) are Ctrl+Alt+Shift+Q on a keyboard and Back/Select+Start+LB+RB pressed together on a controller. Fixed in all three places this text appeared. Also documented the actual working procedure for configuring a Cemu controller and TV audio device, worked out live this session: both need to be done from the Desktop (XFCE) app rather than ES-DE, since Cemu's own Settings dialogs don't render correctly in ES-DE's Sway kiosk session but do in a real XFCE window manager. Desktop shares the same ~/.config/Cemu as ES-DE, so the config carries over. Also notes the real fix for Cemu's TV-audio-device hang (a full Wolf restart, not just reconnecting) that worked in testing, and that /ROMs is now mounted in Desktop too (previous commit) so Cemu can load games directly from there. Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_01VLX1yYKJExGSXmgUhxKQG6 --- services/wolf.sh | 38 +++++++++++++++++++++++++++++++++++--- 1 file changed, 35 insertions(+), 3 deletions(-) diff --git a/services/wolf.sh b/services/wolf.sh index 58ceea2..7541b28 100644 --- a/services/wolf.sh +++ b/services/wolf.sh @@ -3445,7 +3445,7 @@ PYEOF echo " 4. First launch of each app downloads its container image." echo " A black screen for ~60 s is normal." echo "" - echo " Return to launcher: Ctrl+Alt+Shift+W or START+UP+RB (controller)" + echo " Return to launcher: Ctrl+Alt+Shift+Q or Back/Select+Start+LB+RB together (controller)" echo "" echo "── PAIRING (the ./manage.sh pin workflow) ────────────" echo "" @@ -3486,7 +3486,7 @@ PYEOF echo " • Controllers auto-configure: ES-DE & RetroArch map Wolf's virtual pad" echo " via SDL, no manual input setup needed" echo " • Exit a game → ES-DE: Start+Select opens RetroArch menu → Quit," - echo " or the Wolf hotkey START+UP+RB / Ctrl+Alt+Shift+W" + echo " or the Moonlight hotkey Back/Select+Start+LB+RB together / Ctrl+Alt+Shift+Q" echo " • Add / refresh cores later: ./manage.sh cores" echo "" echo " Wolf's entire state folder lives on the game drive, so Steam games" @@ -3681,7 +3681,11 @@ ES-DE is usable the moment you launch it; only ROMs and BIOS are yours to add. To remap inside ES-DE: Main menu → Input device settings → Configure keyboard and controllers. - **Exit a game** back to ES-DE: Start+Select opens the RetroArch menu → Quit, - or use the Wolf hotkey START+UP+RB (Ctrl+Alt+Shift+W on a keyboard). + or use Moonlight's own quit gesture — Back/Select+Start+LB+RB pressed + together on a controller (Ctrl+Alt+Shift+Q on a keyboard). This is a + Moonlight client feature, not something Wolf itself defines — confirmed + against Moonlight's own documented shortcuts after the previously listed + "START+UP+RB" / "Ctrl+Alt+Shift+W" turned out not to work at all. ## GameCube / Wii / PS2 — prefer RetroArch's own cores over standalone RetroArch's libretro cores (Dolphin for GameCube/Wii, PCSX2 for PS2) are @@ -3761,6 +3765,34 @@ releases, auto-offered on install). Two things worth knowing: - Most retail Wii U games are encrypted and need your own Wii U common key (\`keys.txt\`) — Cemu's own First-Time Setup Wizard covers where that goes. +**Controller and audio setup — do this from the Desktop app, not ES-DE.** +Cemu's own Settings dialogs (Input Settings, General Settings) don't render +correctly inside ES-DE's Sway kiosk session — buttons can be unreachable or +invisible even though the dialog box itself shows up. They work fine from +the **Desktop** (XFCE) app instead, and since Desktop shares the exact same +\`~/.config/Cemu\` as ES-DE, whatever you configure there applies the next +time Cemu launches from ES-DE too. + +1. Connect your controller to whichever device is running the **Moonlight + client** (not this server) before connecting. +2. In Moonlight, connect to **Desktop**, open a terminal from its + application menu, and launch Cemu plain: \`~/Applications/Cemu-2.6-x86_64.AppImage\` +3. Controller: **Options → Input Settings → Controller 1** → set Emulated + controller to **Wii U Pro Controller** → click **+** → API **SDL** → + select your controller from the list → use Cemu's own live + button-mapping screen to bind each button → save. +4. Audio: **Options → General Settings → Audio** → set **TV** device to + your real output. +5. If setting the TV device ever hangs Cemu outright (a real, reproducible + Linux Cubeb/PulseAudio stream-open stall, matches cemu-project/Cemu#601 + upstream) — a full Wolf restart (\`sudo ./setup.sh wolf\` from this + repo, not just reconnecting) reliably cleared it in testing, giving a + fresh PulseAudio session to work with. Reconnect to a fresh Desktop + session afterward and try again. + +ROMs are mounted at \`/ROMs\` inside Desktop too, so Cemu's own File → Load +can browse straight to \`/ROMs/wiiu/\` without needing ES-DE at all. + ## TI-99/4A If you said yes to the TI-99/4A prompt during install, it's set up as a real ES-DE system (\`roms/ti994a/\`, artwork scraping, gameplay-time From e3874b2ebe388b6d196e035b7653110732505faf Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 3 Sep 2026 14:30:39 +0000 Subject: [PATCH 2/2] Launch TI-99/4A games fullscreen MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ti99sim-sdl supports --fullscreen directly (confirmed via its own --help output) — add it to the launch command so TI-99/4A games open fullscreen the same way every other standalone emulator here does, instead of a small windowed default. Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_01VLX1yYKJExGSXmgUhxKQG6 --- services/wolf.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/services/wolf.sh b/services/wolf.sh index 7541b28..c273cb4 100644 --- a/services/wolf.sh +++ b/services/wolf.sh @@ -1007,7 +1007,7 @@ block = ''' Texas Instruments TI-99/4A %ROMPATH%/ti994a .ctg .rpk .bin - %INJECT%=%BASENAME%.esprefix %STARTDIR%=%EMUDIR% %EMULATOR_TI99SIM% --joystick1=1 %ROM% + %INJECT%=%BASENAME%.esprefix %STARTDIR%=%EMUDIR% %EMULATOR_TI99SIM% --joystick1=1 --fullscreen %ROM% ti99 ti99