gamescope

Run a program with gamescope

$ gamescope -- [program]

$ gamescope -- %command%

$ gamescope -h 720 -H 1440 -S integer -- [command]

$ gamescope -r 30 -- [command]

$ gamescope -e -- /usr/bin/steam -tenfoot

$ gamescope -O [HDMI-A-1|DP-3|...] -- [program]

$ Super+f

$ gamescope --help

gamescope [options] -- command [arguments]

gamescope is a Wayland micro-compositor developed by Valve for gaming. It acts as an intermediary layer between games and the display server, providing features like resolution scaling, frame limiting, HDR support, and improved game compatibility.
Key features include FSR (FidelityFX Super Resolution) upscaling, integer scaling for retro games, independent refresh rate control, and seamless fullscreen management. It's the basis for the Steam Deck's gaming mode compositor.
When used with Steam (-e flag), it integrates directly with Steam's overlay and game management features.

-h, --nested-height HEIGHT

Set internal (nested) resolution height

Set output resolution height

Set internal (nested) resolution width

Set output resolution width

Set internal refresh rate (FPS limit for vsync games)

Scaling filter: auto, integer, fit, fill, stretch

Enable Steam integration mode

Preferred display output

Start in fullscreen mode

Start in borderless windowed mode

Enable HDR output

Super+F - Toggle fullscreen
Super+S - Take screenshot
Super+G - Toggle FPS limiter

Requires Vulkan support. Some games may have compatibility issues. HDR support requires appropriate hardware and display. Performance overhead is minimal but present.

gamescope was developed by Valve Software and first released in 2020. It was created primarily for the Steam Deck handheld gaming PC, providing the foundation for SteamOS 3.0's gaming compositor. The project evolved from earlier work on the steamcompmgr compositor.

steam(1), cage(1), sway(1)