gamescope 命令

常用示例

说明

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

-H, --output-height _HEIGHT_

Set output resolution height

-w, --nested-width _WIDTH_

Set internal (nested) resolution width

-W, --output-width _WIDTH_

Set output resolution width

-r, --nested-refresh _RATE_

Set internal refresh rate (FPS limit for vsync games)

-S, --scaler _SCALER_

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

-e, --steam

Enable Steam integration mode

-O, --prefer-output _OUTPUT_

Preferred display output

-f, --fullscreen

Start in fullscreen mode

-b, --borderless

Start in borderless windowed mode

-F, --filter _FILTER_

Upscaler filter: linear, nearest, fsr, nis, pixel.

--hdr-enabled

Enable HDR output (requires compatible display and hardware).

--mangoapp

Launch MangoHud overlay (mangoapp) alongside gamescope.

--force-grab-cursor

Always use relative mouse mode instead of flipping between relative and absolute.

--adaptive-sync

Enable adaptive sync / VRR on the output if supported.