Automatically disables VRR / Adaptive Sync for selected Steam games on KDE Plasma Wayland, then restores the previous display policy when the game exits.
Some games behave poorly with VRR enabled. This project adds a Steam launch wrapper that:
- Captures the current VRR policy for each enabled display.
- Disables VRR before the game starts.
- Restores the original VRR policy after the game exits.
The wrapper runs the worker script through systemd-run --user so the display change happens outside the Steam runtime sandbox.
Important: This only changes the OS-level VRR policy. If your monitor firmware forces Adaptive-Sync on, the scripts cannot override that setting.
- Waits for VRR to be disabled before launching the game.
- Supports overlapping wrapped game sessions without restoring VRR too early.
- Cleans up stale session markers after interrupted launches.
- Keeps the AUR and manual-install behavior aligned with the same script paths.
bashjqkscreen-doctorsystemd-runflockfromutil-linux
Install the package with your preferred AUR helper:
yay -S steam-kde-vrr-toggleThe package installs:
steam_vrr_wrapper.shto/usr/bin/steam_vrr_wrapper.shvrr_toggle.shto/usr/lib/steam-kde-vrr-toggle/vrr_toggle.sh
Place both scripts somewhere permanent, then make them executable:
chmod +x /absolute/path/to/vrr_toggle.sh /absolute/path/to/steam_vrr_wrapper.shIf you are not using the packaged path, point the wrapper at the worker script with MAIN_SCRIPT_PATH.
In the Steam game's launch options, use one of these commands.
steam_vrr_wrapper.sh %command%MAIN_SCRIPT_PATH="/absolute/path/to/vrr_toggle.sh" /absolute/path/to/steam_vrr_wrapper.sh %command%If the wrapper cannot toggle VRR, it logs a warning and still launches the game.
To inspect recent worker logs:
journalctl --user --since "10 minutes ago" | grep "VRR_TOGGLE"If the scripts log successful changes but the monitor never flickers or updates, check the monitor OSD and make sure its Adaptive-Sync setting allows OS control.