ValveSoftware/gamescope is tracked by TopGit as an open-source project, with 5.2k stars on GitHub, written primarily in C++. SteamOS session compositing window manager
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
gamescope: the micro-compositor formerly known as steamcompmgr
In an embedded session usecase, gamescope does the same thing as steamcompmgr, but with less extra copies and latency:
It's getting game frames through Wayland by way of Xwayland, so there's no copy within X itself before it gets the frame.
It can use DRM/KMS to directly flip game frames to the screen, even when stretching or when notifications are up, removing another copy.
When it does need to composite with the GPU, it does so with async Vulkan compute, meaning you get to see your frame quick even if the game already has the GPU busy with the next frame.
It also runs on top of a regular desktop, the 'nested' usecase steamcompmgr didn't support.
Because the game is running in its own personal Xwayland sandbox desktop, it can't interfere with your desktop and your desktop can't interfere with it.
You can spoof a virtual screen with a desired resolution and refresh rate as the only thing the game sees, and control/resize the output as needed. This can be useful in exotic display configurations like ultrawide or multi-monitor setups that involve rotation.
It runs on Mesa + AMD or Intel, and could be made to run on other Mesa/DRM drivers with minimal work. AMD requires Mesa 20.3+, Intel requires Mesa 21.2+. For NVIDIA's proprietary driver, version 515.43.04+ is required (make sure the nvidia-drm.modeset=1 kernel parameter is set).
If running RadeonSI clients with older cards (GFX8 and below), currently have to set R600_DEBUG=nodcc, or corruption will be observed until the stack picks up DRM modifiers support.
Super + S : Take screenshot (currently goes to /tmp/gamescope_$DATE.png)
Super + G : Toggle keyboard grab
Examples
On any X11 or Wayland desktop, you can set the Steam launch arguments of your game as follows:
# Upscale a 720p game to 1440p with integer scaling
gamescope -h 720 -H 1440 -S integer -- %command%
# Limit a vsynced game to 30 FPS
gamescope -r 30 -- %command%
# Run the game at 1080p, but scale output to a fullscreen 3440×1440 pillarboxed ultrawide window
gamescope -w 1920 -h 1080 -W 3440 -H 1440 -b -- %command%
Options
See gamescope --help for a full list of options.
-W, -H: set the resolution used by gamescope. Resizing the gamescope window will update these settings. Ignored in embedded mode. If -H is specified but -W isn't, a 16:9 aspect ratio is assumed. Defaults to 1280×720.
-w, -h: set the resolution used by the game. If -h is specified but -w isn't, a 16:9 aspect ratio is assumed. Defaults to the values specified in -W and -H.
-r: set a frame-rate limit for the game. Specified in frames per second. Defaults to unlimited.
-o: set a frame-rate limit for the game when unfocused. Specified in frames per second. Defaults to unlimited.
-F fsr: use AMD FidelityFX™ Super Resolution 1.0 for upscaling
-F nis: use NVIDIA Image Scaling v1.0.3 for upscaling
-F sgsr: use Snapdragon™ Game Super Resolution 1 with RCAS sharpening for upscaling
-S integer: use integer scaling.
-S stretch: use stretch scaling, the game will fill the window. (e.g. 4:3 to 16:9)
-b: create a border-less window.
-f: create a full-screen window.
Reshade support
Gamescope supports a subset of Reshade effects/shaders using the --reshade-effect [path] and --reshade-technique-idx [idx] command line parameters.
This provides an easy way to do shader effects (ie. CRT shader, film grain, debugging HDR with histograms, etc) on top of whatever is being displayed in Gamescope without having to hook into the underlying process.
Uniform/shader options can be modified programmatically via the gamescope-reshade wayland interface. Otherwise, they will just use their initializer values.
Using Reshade effects will increase latency as there will be work performed on the general gfx + compute queue as opposed to only using the realtime async compute queue which can run in tandem with the game's gfx work.
Using Reshade effects is highly discouraged for doing simple transformations which can be achieved with LUTs/CTMs which are possible to do in the DC (Display Core) on AMDGPU at scanout time, or with the current regular async compute composite path.
The looks system where you can specify your own 3D LUTs would be a better alternative for such transformations.
Pull requests for improving Reshade compatibility support are appreciated.
Does ValveSoftware/gamescope have a project website?
No homepage URL was recorded for ValveSoftware/gamescope in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
Is ValveSoftware/gamescope open source?
TopGit's metadata for ValveSoftware/gamescope does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What is ValveSoftware/gamescope?
ValveSoftware/gamescope (ValveSoftware/gamescope) is a C++ project on GitHub. From the project's own README: SteamOS session compositing window manager
Where do I read more about ValveSoftware/gamescope?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/ValveSoftware/gamescope is the definitive source.
Read full README in the tab above.
Curious whether gamescope is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about gamescope.