Skip to content
Tool

Gamescope launch options generator

Pick a preset or set the options, and the generator writes the gamescope command as gamescope <flags> -- %command%. Copy the line into the Launch Options field of a game in Steam. Everything runs in your browser.

Presets

Pick a preset to start, or set the options below.

Launch options

gamescope -W 1920 -H 1080 -f -- %command%

Paste into Steam

  1. Copy the line above.
  2. In Steam: Library > right-click the game > Properties > General > Launch Options, then paste it.

Heroic and Lutris add the game for you: drop %command% and end the line at --.

Resolution

Output resolution

-W / -H Output resolution: the size of the Gamescope window, or what your display gets in fullscreen.

Game render resolution

-w / -h Game resolution: what the game renders at. Leave it the same as the output unless you want to upscale.

Window and frame rate

Window mode

-f / -b -f makes the window fullscreen (Super + F toggles it); -b makes it borderless. With neither, you get a normal window.

-r Long form --nested-refresh. The game's refresh rate, which works as a frame cap. Unlimited by default.

-o The same limit while the Gamescope window is unfocused, for example 30 when alt-tabbed.

--adaptive-sync Enable VRR (FreeSync or G-Sync) if the display supports it.

Upscaling and filter

Filter

-F Upscaler filter: fsr is AMD FSR 1.0, nis is NVIDIA Image Scaling. Visible only when the game resolution is below the output.

Scaler

-S How the image is fitted: integer for pixel art, fit keeps the aspect ratio, fill crops, stretch ignores it.

Display, input and overlay

--hdr-enabled HDR output. Needs an HDR-capable session and the Gamescope WSI layer, otherwise HDR content is tonemapped to SDR.

--expose-wayland Support Wayland clients (xdg-shell) instead of only X11 clients through Xwayland.

--force-grab-cursor Always use relative mouse mode. Fixes a pointer that escapes the window or lands on another monitor.

--immediate-flips Immediate flips, may tear. Listed under embedded (DRM) session options, so a nested window on your desktop ignores it.

--mangoapp Run the MangoHud overlay inside Gamescope, drawn at output resolution. Recommended over wrapping the game in mangohud.

The show and hide key is toggle_hud in ~/.config/MangoHud/MangoHud.conf, Shift_R+F12 by default. mangoapp reads that global file, not per-game wine-<exe>.conf files.

Backend

--backend Nested backend. auto picks wayland on a Wayland session and sdl when only X11 is available.

What each flag does

The generator covers the flags that turn up in real Steam launch options. Uppercase -W/-H is what your display gets, lowercase is what the game draws. Defaults, accepted values and every other option are in the Gamescope flags reference; worked examples, Heroic and Lutris fields, and black-screen fixes are in Steam launch options for Gamescope.

-W / -H
Output resolution: the size of the Gamescope window, or what your display gets in fullscreen.
-w / -h
Game resolution: what the game renders at. Leave it the same as the output unless you want to upscale.
-f / -b
-f makes the window fullscreen (Super + F toggles it); -b makes it borderless. With neither, you get a normal window.
-r
Long form --nested-refresh. The game's refresh rate, which works as a frame cap. Unlimited by default.
-o
The same limit while the Gamescope window is unfocused, for example 30 when alt-tabbed.
-F
Upscaler filter: fsr is AMD FSR 1.0, nis is NVIDIA Image Scaling. Visible only when the game resolution is below the output.
--fsr-sharpness
Sharpness for FSR or NIS, 0 (sharpest) to 20 (softest). Gamescope's default is 2.
-S
How the image is fitted: integer for pixel art, fit keeps the aspect ratio, fill crops, stretch ignores it.
--hdr-enabled
HDR output. Needs an HDR-capable session and the Gamescope WSI layer, otherwise HDR content is tonemapped to SDR.
--adaptive-sync
Enable VRR (FreeSync or G-Sync) if the display supports it.
--expose-wayland
Support Wayland clients (xdg-shell) instead of only X11 clients through Xwayland.
--immediate-flips
Immediate flips, may tear. Listed under embedded (DRM) session options, so a nested window on your desktop ignores it.
--force-grab-cursor
Always use relative mouse mode. Fixes a pointer that escapes the window or lands on another monitor.
--mangoapp
Run the MangoHud overlay inside Gamescope, drawn at output resolution. Recommended over wrapping the game in mangohud.
--backend
Nested backend. auto picks wayland on a Wayland session and sdl when only X11 is available.
-- %command%
Everything after -- is the game. Steam replaces %command% with the real game command line.

Frequently asked questions

Borderless or fullscreen: which should I pick?
Use -f (fullscreen) for a single monitor; Super + F toggles it while the game runs. Use -b (borderless) when you want to move the window or alt-tab often. In nested mode Gamescope opens wherever your desktop places new windows, so if it lands on the wrong monitor, start with -b, move the window, then press Super + F.
Why does Gamescope show a black screen?
Most often the resolution flags are inverted: the game resolution (-w/-h) is larger than the output (-W/-H). Second most often, --hdr-enabled is set on a session without HDR. Remove flags until the game starts, then add them back one at a time, and run the command from a terminal to read Gamescope's log. The Steam launch options guide lists more fixes.
When should I use --expose-wayland?
When the game is a Wayland-native client, typically a native Linux game. Without it Gamescope only accepts X11 clients through Xwayland. Games running through Proton normally connect as X11 clients and start fine without it.
How do I cap FPS with Gamescope?
Add -r with the cap, for example gamescope -r 60 -- %command%. The game sees a 60 Hz display and paces to it. -o sets a separate cap while the window is unfocused, and --framerate-limit is a simpler limiter that works as a divisor of the refresh rate.
Does Gamescope need MangoHud?
No. MangoHud is an optional overlay. If you want it, --mangoapp runs it inside Gamescope at output resolution and reads ~/.config/MangoHud/MangoHud.conf, where toggle_hud sets the show and hide key (Shift_R+F12 by default). Per-game wine-<exe>.conf files are not read by mangoapp; use mangohud %command% after -- if you need them.

More fixes for a black screen, the wrong monitor and an escaping cursor: Gamescope troubleshooting.

Setting up more than a couple of games? ProtonShift's desktop app has a Gamescope builder that writes the line into the game's launch options for you, replacing an existing gamescope prefix instead of nesting a second one. Get started.