Skip to content

About

Deck Mode for Niri: SDDM session flip to Steam Big Picture via gamescope-session

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

NiriShift

License: GPL v3 Arch Linux

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.

Demo

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.

Features

  • 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

NiriShift vs DeckShift

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.

Requirements

  • 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)

Install

git clone https://github.com/ind4skylivey/niri-shift.git
cd niri-shift
./install.sh --backend niri --wire-autostart

Re-login after install if you were added to input or video.

Keybind (Niri)

Add to ~/.config/niri/modules/keybinds.kdl:

Mod+Shift+G hotkey-overlay-title="Gaming Mode" { spawn-sh "niri-shift-switch-to-gaming"; }

Usage

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

./uninstall.sh

Architecture

See docs/ARCHITECTURE.md for the DeckShift audit and Hyprland→Niri mapping.

Contributing

PRs welcome. Read CONTRIBUTING.md for branch naming, backend guidelines, and the PR-first workflow.

Adapters for Sway and other compositors welcome: add backends/your-compositor.sh implementing the backend interface documented in docs/ARCHITECTURE.md.

License

GNU General Public License v3.0 or later (GPL-3.0-or-later). See LICENSE.

Recovery

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"

About

Deck Mode for Niri: SDDM session flip to Steam Big Picture via gamescope-session

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages