ValveSoftware/gamescopeFork
Gamescope
Gamescope is a Wayland micro-compositor that manages frame rates, resolution upscaling, shader application, and virtual displays. It functions as a system to isolate applications within a sandboxed session and control their display output.
The project provides a virtual display manager that spoofs resolution and refresh rates to create a consistent screen environment independent of physical hardware. It includes a GPU post-processing wrapper to apply visual shaders and filters to an application stream and a game resolution upscaler to improve visual clarity on larger displays.
The system manages frame rate limiting for focused and unfocused windows and utilizes asynchronous compute and direct flipping to reduce input lag. It also features a scripting extension interface that executes custom scripts via operational hooks to modify configuration and behavior at runtime.
Features
- Sandboxed Wayland Sessions - Runs each game in its own sandboxed Wayland session with a virtual display as a micro-compositor.
- Wayland Gaming Compositors - Provides the core Wayland micro-compositor that isolates and manages game display output.
- Resolution Upscalers - Scales application rendered output to higher display resolutions using configurable filtering.
- XWayland Integrations - Integrates XWayland to run legacy X11 applications within the Wayland compositor session.
- Game Graphics Upscalers - Uses FSR, NIS, or integer scaling to resize game output to the display.
- Game Output Upscaling Filters - Scales the game's rendered image to a higher output resolution using integer, FSR, or NIS filtering, adjustable via keyboard shortcuts.
- GPU Post-Processing Wrappers - Provides a GPU post-processing wrapper that applies ReShade shaders to composited output.
- Shader Filter Applications - Applies ReShade-compatible shader effects like CRT or film grain to composited game output.
- Asynchronous Frame Flipping - Implements asynchronous frame flipping to reduce input latency in the compositor.
- Output Frame Rate Throttling - Controls the composited output frame rate independently from the application's internal rate.
- Compositor Output Resolutions - Sets the compositor's output resolution, game internal resolution, and frame-rate limits for focused and unfocused states.
- Virtual Display Spoofing - Spoofs a virtual screen with a custom resolution and refresh rate that the game sees, while resizing the output window independently.
- Virtual Display Emulators - Presents a virtual screen with custom resolution and refresh rate to the game.
- Game Session Isolation - Runs each game in its own Xwayland desktop to prevent interference with the host system.
- Application Sandboxes - Isolates each game in its own Xwayland desktop to prevent interference with the host system.
- Focused-Unfocused Frame Rate Limits - Ships a frame rate limiting engine that applies different caps to focused and unfocused windows.
- Application Event Dispatching - Routes keyboard and pointer events from the compositor to the correct sandboxed application.
- XWayland Bridges - Integrates XWayland to run legacy X11 applications within the Wayland compositor session.
- Custom Key Action Bindings - Maps physical input events to custom compositor actions for controlling the sandboxed session.
- Display Frame Streams - Exports composited display frames as a PipeWire video stream for recording or remote viewing.
- Display Buffer Managers - Coordinates allocation and presentation of graphics buffers between the application and compositor.
- ReShade-Compatible Shader Loading - Loads and applies ReShade-compatible shader effects to the final composited image before display.
- ReShade Shader Overlays - Loads Reshade shader effects (e.g., CRT, film grain, HDR histograms) on top of the displayed content without hooking into the game process.
- Compositor Scripting Hooks - Executes custom scripts via operational hooks to modify compositor configuration and behavior at runtime.
- Application Window Managers - Controls the placement, sizing, and stacking of application windows on the display.
- Color Management Systems - Manages color metadata and applies color transformations to sandboxed application output.
- Display Mode Toggles - Switches between fullscreen, borderless, and windowed modes via keyboard shortcuts.
- Windowed Fullscreen Toggles - Switches the compositor window between fullscreen and windowed mode and toggles keyboard capture.
- Compositors and Shells - Compositor designed for SteamOS.
