Deck Mode for Niri and other Wayland compositors: SDDM session flip between your desktop and Steam Big Picture via ChimeraOS gamescope-session.
Inspired by DeckShift (Omarchy/Hyprland), reimplemented without Omarchy dependencies.
Screenshot or GIF coming soon. See docs/assets/README-demo.md for capture notes.
Flow: desktop (Niri) → Mod+Shift+G → Gaming Mode (gamescope-session-steam) → Super+Shift+R → desktop.
- Session flip: desktop (Niri) ↔ Gaming Mode (
gamescope-session-steam) through SDDM restart - Compositor backends:
niri(first-class),hyprland(adapter stub) - Exit shortcut: Super+Shift+R inside Gaming Mode (evdev monitor)
- Settings TUI:
niri-shift-settings(gum) for display, refresh, multi-monitor - Portal recovery: optional autostart hook after returning from gaming
| DeckShift | NiriShift | |
|---|---|---|
| Compositor | Hyprland / Omarchy | Niri (Hyprland adapter stub) |
| Settings UI | Omarchy QML plugin | gum TUI (niri-shift-settings) |
| Dependencies | Omarchy stack | Arch + SDDM + gamescope-session (no Omarchy) |
Full audit: docs/ARCHITECTURE.md.
- Arch Linux (or derivative) with SDDM
- Niri (or Hyprland with
--backend hyprland) - AUR:
gamescope-session-git,gamescope-session-steam-git - Groups:
video(session switch sudo),input(keybind monitor)
git clone https://github.com/ind4skylivey/niri-shift.git
cd niri-shift
./install.sh --backend niri --wire-autostartRe-login after install if you were added to input or video.
Add to ~/.config/niri/modules/keybinds.kdl:
Mod+Shift+G hotkey-overlay-title="Gaming Mode" { spawn-sh "niri-shift-switch-to-gaming"; }| Action | Command |
|---|---|
| Settings | niri-shift-settings |
| Enter Gaming Mode | niri-shift-switch-to-gaming or keybind |
| Exit Gaming Mode | Super+Shift+R (in gaming session) |
| CLI | niri-shift help |
./uninstall.shSee docs/ARCHITECTURE.md for the DeckShift audit and Hyprland→Niri mapping.
PRs welcome. Read CONTRIBUTING.md for branch naming, backend guidelines, and the PR-first workflow.
- Questions: GitHub Discussions
- Bugs / features: Issues
Adapters for Sway and other compositors welcome: add backends/your-compositor.sh implementing the backend interface documented in docs/ARCHITECTURE.md.
GNU General Public License v3.0 or later (GPL-3.0-or-later). See LICENSE.
Black screen after switch: see docs/RECOVERY.md or switch to TTY (Ctrl+Alt+F3), then:
sudo systemctl restart sddm
# or
loginctl terminate-user "$USER"