jose/chimera-steam-switch
1
0
Fork 0
Code Issues Pull requests Projects Releases 3 Packages Wiki Activity Actions
No description
12 commits 1 branch 3 tags 58 KiB
Find a file
Jose Falanga c941539b47
All checks were successful
Build plugin / build (push) Successful in 1m14s
Details
Bump version to v0.1.4
2026-08-19 16:42:26 -03:00
.forgejo/workflows Rename plugin to chimera-steam-switch (ChimeraOS-only) 2026-08-16 20:43:06 -03:00
assets Add publish metadata: MIT license, README, icon, store tags, working make dist 2026-08-07 22:24:09 -03:00
docs Add publish metadata: MIT license, README, icon, store tags, working make dist 2026-08-07 22:24:09 -03:00
.gitignore Add publish metadata: MIT license, README, icon, store tags, working make dist 2026-08-07 22:24:09 -03:00
export_presets.cfg Add Session Switch plugin: 'Switch to Steam' power menu button for OpenGamepadUI 2026-08-07 01:34:02 -03:00
LICENSE Add publish metadata: MIT license, README, icon, store tags, working make dist 2026-08-07 22:24:09 -03:00
Makefile Add publish metadata: MIT license, README, icon, store tags, working make dist 2026-08-07 22:24:09 -03:00
plugin.gd readability: MAX_POLL_FRAMES, _poll_for_power_menu, BUTTON_LABEL 2026-08-19 16:41:33 -03:00
plugin.json Bump version to v0.1.4 2026-08-19 16:42:26 -03:00
README.md Add publish metadata: MIT license, README, icon, store tags, working make dist 2026-08-07 22:24:09 -03:00

README.md

Session Switch

An OpenGamepadUI plugin that adds a Switch to Steam button to the power menu so OpenGamepadUI can return to Steam game mode.

OpenGamepadUI's built-in ChimeraOS platform support adds a "Switch to Desktop" button but has no way to get back to Steam game mode once you leave it. This plugin adds the missing round-trip button.

Features

  • Adds a Switch to Steam button to the power menu, right above the exit button.
  • Returns to the session that was active before OpenGamepadUI took over, so your autologin configuration is left untouched.
  • Restarts InputPlumber before switching so the gamepad is not left in an exclusive (blocked) state for Steam.
  • No configuration required.

Requirements

  • ChimeraOS or SteamOS with OpenGamepadUI running as an exclusive session.
  • Godot 4.4.x on the build machine (the plugin bytecode must match the Godot version embedded in the OpenGamepadUI release you are targeting).

Installation

Download the plugin zip and place it in the plugins directory (~/.local/share/opengamepadui/plugins), or build it yourself:

make dist

Then restart OpenGamepadUI. The Switch to Steam button appears in the power menu.

How it works

  • The plugin only activates when the OS session switcher (/usr/lib/os-session-select) is present. On other systems the button is never added.
  • Pressing Switch to Steam runs os-session-select <return-session>, where <return-session> is the value ChimeraOS recorded in ~/.config/chimeraos-session-return before OpenGamepadUI took over (falling back to gamescope-session-steam-plus).
  • Before switching, it runs sudo -n systemctl restart inputplumber. ChimeraOS's default sudoers grants passwordless access to exactly this command, so the switch stays non-interactive. If passwordless sudo for systemctl restart inputplumber is not configured on your system, the restart is skipped with a warning and the switch still proceeds.

Compatibility

Tested with OpenGamepadUI v0.40.4 on ChimeraOS. The plugin pins to the OpenGamepadUI tag it is built against (OPENGAMEPAD_UI_TAG in the Makefile) so the compiled plugin bytecode always matches the running OpenGamepadUI version.

License

MIT