nosignal/super-alt-S-cachy-deckmode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
super-alt-S-cachy-deckmode/README.md

6.8 KiB
Raw Blame History

Super Alt S - Gaming Mode for KDE Plasma

Switch between KDE Plasma desktop and Steam Big Picture Gaming Mode with a keyboard shortcut. Built for Arch Linux and CachyOS.

Super+Alt+S to enter Gaming Mode. Super+Alt+R to return to desktop.

What it does

This installer sets up a full console-like gaming experience on your KDE Plasma desktop by configuring:

  • Gamescope session using ChimeraOS packages (gamescope-session-git, gamescope-session-steam-git)
  • Steam Big Picture running in a dedicated Wayland session via gamescope
  • One-key switching between KDE Plasma and Gaming Mode via SDDM session management
  • GPU auto-detection for NVIDIA, AMD dGPU, and AMD APU systems
  • Performance mode with CPU governor, GPU power management, and kernel tuning
  • NetworkManager integration so Steam has network access even if your desktop uses iwd/systemd-networkd
  • External drive auto-mounting for Steam libraries on secondary drives
  • Shader cache optimisation for reduced stuttering
  • Installation verification to confirm everything is set up correctly

Requirements

  • Arch Linux or CachyOS (or any Arch-based distro with KDE Plasma)
  • KDE Plasma 6 (Wayland)
  • SDDM display manager
  • AMD or NVIDIA GPU (Intel-only is not supported)
  • Steam (installed during setup if missing)
  • AUR helper (yay or paru) for ChimeraOS session packages

Install

git clone https://git.no-signal.uk/nosignal/super-alt-s.git
cd super-alt-s
chmod +x super-alt-s.sh
./super-alt-s.sh

The installer is interactive and will walk you through each step, asking before making changes.

Usage

Action Shortcut
Enter Gaming Mode Super+Alt+S (from KDE Plasma)
Return to Desktop Super+Alt+R (from Gaming Mode)
Return to Desktop (fallback) Steam > Power > Exit to Desktop

What gets installed

Packages (via pacman + AUR)

  • Steam and all required 32-bit libraries
  • GPU-specific Vulkan drivers (NVIDIA or AMD)
  • gamescope, mangohud, gamemode, proton-ge-custom-bin
  • gamescope-session-git + gamescope-session-steam-git (ChimeraOS AUR packages)
  • python-evdev (for keybind monitoring)

Scripts

File Purpose
/usr/local/bin/switch-to-gaming Switches from KDE to Gaming Mode
/usr/local/bin/switch-to-desktop Switches from Gaming Mode to KDE
/usr/local/bin/gamescope-session-nm-wrapper Session wrapper with NetworkManager + performance mode
/usr/local/bin/gaming-keybind-monitor Python daemon monitoring Super+Alt+R in Gaming Mode
/usr/local/bin/gaming-session-switch Updates SDDM config for session switching
/usr/local/bin/gamescope-nm-start Starts NetworkManager for gaming session
/usr/local/bin/gamescope-nm-stop Stops NetworkManager and restores iwd
/usr/local/bin/steam-library-mount Auto-mounts external drives with Steam libraries
/usr/lib/os-session-select Handles Steam's "Exit to Desktop" menu option

System config

File Purpose
/etc/sddm.conf.d/zz-gaming-session.conf SDDM autologin session switching
/etc/sudoers.d/gaming-session-switch Passwordless sudo for session switching
/etc/sudoers.d/gaming-mode-sysctl Passwordless sudo for performance tuning
/etc/udev/rules.d/99-gaming-performance.rules CPU/GPU sysfs permissions
/etc/security/limits.d/99-gaming-memlock.conf Memory lock limits for esync
/etc/pipewire/pipewire.conf.d/10-gaming-latency.conf Low-latency audio
/etc/environment.d/99-shader-cache.conf Shader cache sizes
/etc/polkit-1/rules.d/50-gamescope-networkmanager.rules NM access for wheel group
/etc/polkit-1/rules.d/50-udisks-gaming.rules Drive mount access for wheel group

User config

File Purpose
~/.config/environment.d/gamescope-session-plus.conf Resolution, refresh rate, GPU settings
~/.config/kglobalshortcutsrc Super+Alt+S shortcut registration

GPU support

NVIDIA

  • Auto-detects NVIDIA GPU and installs required drivers/utils
  • Checks and configures nvidia-drm.modeset=1 kernel parameter (supports GRUB, systemd-boot, and Limine)
  • Sets up GBM backend and Vulkan adapter
  • NVIDIA gamescope wrapper with --force-composition if supported
  • Caps resolution at 2560x1440 for gamescope compatibility
  • Performance mode includes persistence mode, max power limit, and runtime suspend disable

AMD (dGPU)

  • Installs Vulkan RADEON drivers
  • Enables adaptive sync and HDR
  • Distinguishes between discrete GPUs and integrated APUs using PCI device identification

AMD APU

  • Supported as a fallback when no discrete GPU is found
  • Same session setup with APU-specific display detection

Verify installation

Run verification without reinstalling:

./super-alt-s.sh --verify

This checks all files, permissions, packages, user groups, and service status.

Options

./super-alt-s.sh              # Full install
./super-alt-s.sh --verify     # Verification only
./super-alt-s.sh --version    # Show version
./super-alt-s.sh --help       # Show help

How it works

  1. KDE to Gaming Mode (Super+Alt+S): The switch-to-gaming script updates SDDM's session config to gamescope-session-steam-nm, kills any existing gamescope, and restarts SDDM. SDDM auto-logs in to the gaming session.

  2. Gaming session startup: The gamescope-session-nm-wrapper enables performance mode (CPU governor, GPU power), starts NetworkManager, launches the Steam library drive monitor, starts the keybind monitor, then hands off to ChimeraOS's gamescope-session-plus which launches gamescope with Steam.

  3. Gaming Mode to KDE (Super+Alt+R): The gaming-keybind-monitor Python daemon detects the key combo via evdev and calls switch-to-desktop, which shuts down Steam, kills gamescope, updates SDDM config back to KDE Plasma, and restarts SDDM.

  4. Cleanup on exit: Performance mode is restored to balanced, NetworkManager is stopped (iwd restarted if needed), drive monitor and keybind monitor are killed.

Troubleshooting

No network in Gaming Mode

  • Check NetworkManager is installed: pacman -S networkmanager
  • Test manually: sudo systemctl start NetworkManager && nmcli general
  • Check logs: journalctl -u NetworkManager -n 50

Shortcut not working in KDE

  • Log out and back in after install
  • Or set manually: System Settings > Shortcuts > search "Gaming Mode"

Super+Alt+R not working in Gaming Mode

  • Ensure you're in the input group: groups | grep input
  • Check python-evdev: python3 -c "import evdev"
  • Check input devices: ls /dev/input/event*

NVIDIA: black screen or no display

  • Verify kernel parameter: cat /proc/cmdline | grep nvidia-drm.modeset
  • Reboot if you just added the parameter
  • Check DRM cards: ls /sys/class/drm/card*/device/driver -la

License

MIT