ScopeBuddy

Spec sheet

Purpose

ScopeBuddy is a manager script that makes Gamescope easier to use on the desktop.Read 8 Oct 2026 · github.com

License

The repository includes the Apache License, Version 2.0.Read 8 Oct 2026 · github.com

Configuration

It supports global and per-game Gamescope arguments and environment variables.Read 8 Oct 2026 · github.com

Configuration scripts

ScopeBuddy configuration files are sourced as Bash scripts before Gamescope and the game run, allowing users to run scripts as part of launch configuration.Read 8 Oct 2026 · docs.bazzite.gg

Desktop environments

Display detection supports KDE Plasma, GNOME, and wlroots compositors, using tools such as kscreen-doctor, gdctl, gnome-randr, and wlr-randr.Read 8 Oct 2026 · github.com

Display detection

It can detect display resolution, HDR, VRR, and refresh rate, with documented compositor-specific requirements and limitations.Read 8 Oct 2026 · github.com

Downloads

Installation instructions cover direct script downloads, versioned GitHub releases, NixOS flakes, Fedora derivatives, and Arch Linux via the AUR.Read 8 Oct 2026 · github.com

Experimental HDR

HDR in non-gamescope contexts is experimental and requires a Proton 10 or newer variant with experimental Wayland support.Read 8 Oct 2026 · github.com

Game configuration

It supports global and per-game gamescope arguments and environment variables.Read 8 Oct 2026 · github.com

Game launchers

The documentation gives setup instructions for Steam and Lutris and describes rudimentary AppID-like configuration for launchers such as Lutris or Heroic.Read 8 Oct 2026 · docs.bazzite.gg

GUI

The README points to a community-made graphical configuration tool called ScopeBuddy-GUI.Read 8 Oct 2026 · github.com

Installation

The project documents manual script installation, NixOS Home Manager flakes, Fedora derivatives through Terra, and an Arch AUR package.Read 8 Oct 2026 · github.com

Launchers

The documentation describes using ScopeBuddy with Steam and Lutris, and says manually assigned app identifiers can support configuration files for launchers such as Heroic.Read 8 Oct 2026 · docs.bazzite.gg

No-gamescope mode

Setting SCB_NOSCOPE=1 lets users use ScopeBuddy functions while bypassing gamescope.Read 8 Oct 2026 · docs.bazzite.gg

Overlay and input

It fixes Steam Overlay and SteamInput when used with nested gamescope in desktop mode.Read 8 Oct 2026 · github.com

Requirements

The listed requirements are Bash, Gamescope, Perl, and awk; some display auto-detection features require additional compositor tools and jq.Read 8 Oct 2026 · github.com

Steam fixes

It fixes the Steam Overlay and SteamInput when using nested Gamescope in desktop mode.Read 8 Oct 2026 · github.com

Steam Gaming Mode

When it detects Steam Gaming Mode, ScopeBuddy can skip Gamescope and use a separate configuration.Read 8 Oct 2026 · docs.bazzite.gg

Where Specifiction places it

• Game Graphics Optimization Software#31 of 346.6
• Graphics optimisers#34 of 356.5