Steam / Gamescope gaming mode launcher for Omarchy OS (Hyprland, Arch)
Find a file
2025-11-23 19:45:34 +00:00
Configuration Configuration 2025-11-23 19:32:30 +00:00
Contributing Contributing 2025-11-23 19:45:34 +00:00
files and Paths Create files and Paths 2025-11-23 19:34:07 +00:00
Installation Installation 2025-11-23 19:30:52 +00:00
Known limitations Known limitations 2025-11-23 19:37:26 +00:00
Launch summary.png Add files via upload 2025-11-23 19:21:29 +00:00
LICENSE Update LICENSE 2025-11-23 14:30:31 +00:00
MangoHud overlay selection.png Add files via upload 2025-11-23 19:21:29 +00:00
Previous settings prompt.png Add files via upload 2025-11-23 19:21:29 +00:00
README.md README.md 2025-11-23 19:26:53 +00:00
Requirements Requirements 2025-11-23 19:27:28 +00:00
Resolution selection.png Add files via upload 2025-11-23 19:21:29 +00:00
Screenshots Screenshots 2025-11-23 19:15:07 +00:00
TROUBLESHOOTING.md TROUBLESHOOTING.md 2025-11-23 19:43:22 +00:00
Uninstall Uninstall 2025-11-23 19:36:53 +00:00
Usage Usage 2025-11-23 19:31:37 +00:00
WOPR.sh Add files via upload 2025-11-23 19:43:54 +00:00

W.O.P.R. Steam Gaming Mode Launcher for OMARCHY (Arch)

“Shall we play a game?”

W.O.P.R. is an opinionated Steam “gaming mode” launcher for Arch-based systems running Hyprland.

It installs all the bits you need for a SteamOS-style experience (Steam, Gamescope, MangoHud, GameMode, 32-bit libs, GPU drivers), wires everything into Hyprland keybinds, and gives you a friendly TUI to pick resolution and performance overlay before it launches Steam.

Once installed:

  • SUPER+SHIFT+Senter Gaming Mode
  • SUPER+SHIFT+Rexit Gaming Mode and restore your desktop

Features

  • 🎮 One-key Steam “Gaming Mode”
    • Launches Steam inside Gamescope using a floating, pinned TUI
    • Default keybinds: SUPER+SHIFT+S to start, SUPER+SHIFT+R to exit
  • 🖥️ Resolution presets & scaling
    • Native panel resolution
    • 1080p → 1440p upscaled
    • Native 1440p
    • 1440p → 4K upscaled
    • Native 4K/UHD (3840×2160)
  • 📊 MangoHud presets
    • Off (clean view)
    • Minimal FPS counter only
    • Full stats CPU, GPU, frametime, temps, etc.
  • ⚙️ Automatic GPU detection
    • NVIDIA, AMD, Intel iGPU, Intel Arc
    • Installs appropriate Vulkan and 32-bit driver stacks via pacman
  • 🚀 Performance mode (optional)
    • Temporarily switches CPU governor and GPU power/performance settings for gaming
    • Uses udev rules so later launches do not require sudo
    • Restores everything cleanly when you exit gaming mode
  • 🧠 Remembers your choices
    • Saves last used resolution and overlay and offers to reuse them next time
  • 🎨 Themed TUI with gum
    • Uses your terminals colours (Ghostty/kitty/Alacritty/foot/xterm)
    • Clean centred layout with a WarGames-style header
  • 🧩 Intel Arc quality-of-life fixes
    • Optional GTK4 rendering workaround (sets GSK_RENDERER=gl) to fix visual glitches in Nautilus and other GTK4 apps
  • 🧰 Arch-friendly installer
    • Checks multilib, Steam dependencies and 32-bit libs
    • Offers a full system upgrade (pacman -Syu) before installing anything
    • Rolls back cleanly if something fails