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
- Copy the line above.
- 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
-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.
Window and frame rate
-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
-F Upscaler filter: fsr is AMD FSR 1.0, nis is NVIDIA Image Scaling. Visible only when the game resolution is below the output.
-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 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.