Installation

This commit is contained in:
Gavin Nugent 2025-11-23 19:30:52 +00:00 committed by GitHub
parent 6ff89790d3
commit da3974bd8d
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -1,19 +1,63 @@
git clone https://github.com/<your-user>/<your-repo>.git git clone https://github.com/YOUR-USER/WOPR-gaming-mode.git
cd WOPR-gaming-mode
cd <your-repo>
chmod +x WOPR.sh chmod +x WOPR.sh
./WOPR.sh ./WOPR.sh
During the first run the installer will:
The installer will: 1. Validate environment
1. Check your environment
2. Offer a system upgrade (recommended)
3. Install missing packages
4. Deploy enter-gamesmode / leave-gamesmode
5. Add Hyprland keybinds and window rules
At the end it will tell you if you need to log out and back in • Verifies pacman, hyprctl and a Hypr config are present.
(e.g. because your user was added to new groups).
2. Refresh and optionally upgrade the system
• Runs pacman -Syy
• Optionally runs pacman -Syu (you can skip, but may hit dependency issues later).
3. Check and install dependencies
• Steam and its 32-bit libraries
• Gamescope
• MangoHud
• GameMode
• gum
• GPU-specific Vulkan drivers and supporting libs
4. Ensure multilib is enabled
• Warns you and offers to add [multilib] to /etc/pacman.conf if needed.
5. Set up performance permissions (optional)
• Creates /etc/udev/rules.d/99-gaming-performance.rules
• Allows your user to change CPU governors and certain GPU performance knobs without typing your password each time.
6. Create launcher scripts
• ~/.local/share/steam-launcher/enter-gamesmode
• ~/.local/share/steam-launcher/leave-gamesmode
7. Add Hyprland bindings and window rules
• Appends a block to your bindings config:
# Gaming Mode bindings - added by installation script
windowrulev2 = float, class:(YOUR_TERMINAL_CLASS)
windowrulev2 = size 800 600, class:(YOUR_TERMINAL_CLASS)
windowrulev2 = center, class:(YOUR_TERMINAL_CLASS)
windowrulev2 = pin, class:(YOUR_TERMINAL_CLASS)
# bindd style if you use bindd:
bindd = SUPER SHIFT, S, Steam Gaming Mode, exec, YOUR_TERMINAL_CMD ~/.local/share/steam-launcher/enter-gamesmode
bindd = SUPER SHIFT, R, Exit Gaming Mode, exec, ~/.local/share/steam-launcher/leave-gamesmode
# or plain bind = ... if your config uses that
# End Gaming Mode bindings
8. Intel Arc option (if applicable)
• If an Intel Arc GPU is detected, offers to add a GTK4 environment file under /etc/environment.d/ or ~/.config/environment.d/ that forces GSK_RENDERER=gl.
If you are asked to log out / reboot (e.g. after udev or environment changes), do that once the script finishes.