nosignal/W.O.P.R
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

TROUBLESHOOTING.md

Browse source
This commit is contained in:
Gavin Nugent 2025-11-23 19:40:27 +00:00 • committed by GitHub
parent 75b8cac749
commit 643f50cc09
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 42 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

42
TROUBLESHOOTING.md Normal file
View file

@ -0,0 +1,42 @@
# Troubleshooting
A few common issues and fixes when using W.O.P.R.
---
## Gamescope fails to start
**Symptoms**
- You see “ERROR: Gamescope failed to start!”
- Gaming Mode exits immediately after the spinner
**Things to check**
1. Run `gamescope --help` from a terminal to confirm it is installed.
2. Make sure your GPU has working Vulkan support:
- `vulkaninfo | less` (from `vulkan-tools`)
3. Confirm you’re on a supported GPU driver:
- NVIDIA: `nvidia`, `nvidia-dkms`, or `nvidia-open-dkms`
- AMD: `amdgpu` with `vulkan-radeon`
- Intel / Arc: recent Mesa recommended
Re-run `./WOPR.sh` to let it re-check dependencies if needed.
---
## Keybinds don’t work
**Symptoms**
- `SUPER`+`SHIFT`+`S` does nothing
**Checks**
1. Open your Hypr config (e.g. `~/.config/hypr/bindings.conf`).
2. Look for the block:
```ini
# Gaming Mode bindings - added by installation script
...
# End Gaming Mode bindings