NoSignal-OS/os updates/gamemode-toggle-deckshift/README.md

gamemode-toggle-deckshift — Game Mode toggle launches DeckShift

Companion to gaming-key-guard (which does the Super+Shift+S keybind). Patches the package-owned nosignal-shell file; the canonical fix is in the fork.

Request

The utilities Game Mode button (gamepad icon) should launch the DeckShift gaming session when DeckShift is installed, and do nothing otherwise. Previously it ran caelestia's cosmetic Game Mode (disable Hyprland animations/blur/gaps).

Change

modules/utilities/cards/Toggles.qml, the gameMode DelegateChoice:

before

delegate: Toggle {
    icon: "gamepad"
    checked: GameMode.enabled
    onClicked: GameMode.enabled = !GameMode.enabled
}

after (hardened)

delegate: Toggle {
    id: gmTog
    property bool launching: false
    icon: "gamepad"
    disabled: launching
    onClicked: {
        if (gmTog.launching) return;
        gmTog.launching = true;
        gmTog.internalChecked = false; // don't latch "on" — it's a launcher
        relockTimer.start();
        Quickshell.execDetached(["sh", "-c", "[ -x /usr/local/bin/switch-to-gaming ] && [ -f /usr/share/wayland-sessions/gamescope-session-steam-nm.desktop ] && exec /usr/local/bin/switch-to-gaming"]);
    }
    Timer { id: relockTimer; interval: 5000; onTriggered: gmTog.launching = false }
}

• Kept styled as an off-toggle (default isToggle: true, no checked) so it keeps the muted/outline look of the other toggles. An earlier version set isToggle: false, which flipped the icon to filled/accent — that was the reported "changed colour"; reverted. internalChecked is reset to false on click so the launcher never latches "on".
• Debounced. A fast double-click previously fired switch-to-gaming twice → two systemctl restart sddm calls → the first restart consumed the one-shot autologin marker and the second fell back to the password greeter (the reported "takes you to the login screen, not gamescope"). The launching guard + disabled + 5 s relockTimer ensure one launch per press.
• The sh -c '… && … && exec switch-to-gaming' guard mirrors the Super+Shift+S bind and the deckshift-login install-check: nothing happens if DeckShift is absent.
• Adds import Quickshell (for execDetached; the file only had Quickshell.Bluetooth). GameMode (from qs.services) is no longer referenced here — the cosmetic Game Mode is still available via its IPC (gameMode target) if a future build wants to re-expose it elsewhere.
• Hidden when DeckShift isn't installed. A deckshiftProbe Process (test -f /usr/share/wayland-sessions/gamescope-session-steam-nm.desktop) sets root.deckshiftInstalled at load, and the quickToggles filter drops the gameMode entry when it's false (same pattern as the existing vpn special-case) — so the tile cleanly leaves the grid (no dead button, no gap) on non-gaming boxes, and appears once DeckShift is installed (after a shell reload). Needs import Quickshell.Io for Process.

Pieces / integration

1. Toggles.qml — corrected file (drop-in for modules/utilities/cards/Toggles.qml in the nosignal-shell fork). Rebuild the package; set NOSIGNAL_SKIP_SHELL_PATCH for the build.
2. install-gamemode-toggle-deckshift.sh — idempotent fallback patch (backup + overwrite). Reverted by the next nosignal-shell upgrade (which carries the fix).
3. 1781478000-gamemode-toggle-deckshift.sh → nosignal-update/migrations/ (delegates via $NOSIGNAL_SRC).

Shell restart required: qs -c caelestia -n -d disables the file watcher, so the patched file is not hot-reloaded — restart the shell (Ctrl+Super+Alt+R) or log out/in after patching.

Apply on this box now (needs root)

sudo sh ~/nosignal-handoff/gamemode-toggle-deckshift/install-gamemode-toggle-deckshift.sh

then Ctrl+Super+Alt+R.