Difference between revisions of "Gamescope"

From Linux Gaming
Jump to navigation Jump to search
m (Add references and change formatting)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[https://github.com/Plagman/gamescope Gamescope] creates a virtual desktop for your game. This can be beneficial if your game doesn't play nicely with your desktop, for example if it doesn't catch your mouse, or if it breaks when loosing focus.
[https://github.com/ValveSoftware/gamescope Gamescope] is a [https://en.wikipedia.org/wiki/Compositing_window_manager compositor]. It creates a virtual desktop and can upscale a game window. This can be beneficial if it doesn't play nicely with your desktop, if the window doesn't grab your mouse or if it breaks when loosing focus.


You can use Gamescope for downsampling. For example, use <code>gamescope -w 3840 -h 2160 --</code> as command prefix, to downscale from 4k. If you use it in Lutris, set <code>3840x2160</code> as resolution.
== Setup ==
You can usually install Gamescope from your distribution official repository. To check if it's installed, run <code>gamescope --help</code> in a [[terminal]] emulator. To get a smooth gaming experience, run <code>sudo setcap 'CAP_SYS_NICE=eip' $(which gamescope)</code><ref>https://wiki.archlinux.org/title/Gamescope#Setting_Gamescopes_priority</ref>.


=== Setup ===
== Usage ==
Run <code>sudo setcap 'CAP_SYS_NICE=eip' `which gamescope`</code> to get a smooth gaming experience.
To run Gamescope with your game, you just have to append your binary path. So, if you use Wine from the command-line and want to limit a game to 30 FPS use <code>gamescope -r 30 -- wine game.exe</code><ref>https://github.com/ValveSoftware/gamescope#examples</ref>. While you can use the command prefix field on launchers like [[Lutris]] or [[Bottles]], Gamescope should have its own sections with multiple options available.
 
=== Keyboard shortcuts<ref>https://github.com/ValveSoftware/gamescope#keyboard-shortcuts</ref> ===
* '''Super + F''': Toggle fullscreen
* '''Super + N''': Toggle nearest neighbour filtering
* '''Super + U''': Toggle FSR upscaling
* '''Super + Y''': Toggle NIS upscaling
* '''Super + I''': Increase FSR sharpness by 1
* '''Super + O''': Decrease FSR sharpness by 1
* '''Super + S''': Take screenshot (goes to <code>/tmp/gamescope_$DATE.png</code>)
* '''Super + G''': Toggle keyboard grab
 
=== Upscaling ===
Gamescope can be used for upscaling with [[FSR - FidelityFX Super Resolution|AMD FidelityFX™ Super Resolution]] or NVIDIA Image Scaling: set <code>gamescope -F fsr --sharpness 4 -- %command%</code> or <code>gamescope -F nis --sharpness 4 -- %command%</code> as a command prefix. "4" is an example value, replace it by something between "0" and "20". This also works for native games and can also be used with another resolution: <code>gamescope -w 1920 -h 1080 -W 3840 -H 2160 -F nis --sharpness 4 -- game</code><ref>https://wiki.archlinux.org/title/Gamescope#Upscaling</ref>.
 
=== Downsampling ===
You can use Gamescope for downsampling too. For example, use <code>gamescope -f -w 3840 -h 2160 -- %command%</code> as a command prefix, to downscale from 4K. The same can be achieved in Lutris by enabling Gamescope and setting "3840x2160" as resolution.
 
== Troubleshooting ==
* If you experience stuttering and lag, try running <code>gamescope --rt -r <desired_framerate> --immediate-flips -- %command%</code> where <code><desired_framerate></code> is a number.
* Some games have issues like video playblack or black/white screens when the environment variable <code>ENABLE_GAMESCOPE_WSI</code> is set to "1": use <code>ENABLE_GAMESCOPE_WSI=0</code> to fix them<ref>https://github.com/ValveSoftware/gamescope/issues/1182</ref>.
* Shortcuts might not work on GNOME<ref>https://github.com/ValveSoftware/gamescope/issues/424</ref> but they can be fixed by unchecking the "Gamescope" option in the Lutris settings and using the command prefix field.
* If you run a game from Steam with Gamescope, you could experience stuttering after 30 minutes<ref>https://wiki.archlinux.org/title/Gamescope#Launching_gamescope_from_Steam,_stuttering_after_~24_minutes_(Gamescope_Lag_Bomb)</ref>.
* If you need to use MangoHud with Gamescope, don't chain both commands but use the <code>--mangoapp</code> argument with Gamescope<ref>https://github.com/flightlessmango/MangoHud#gamescope</ref>.

Latest revision as of 05:45, 12 May 2025

Gamescope is a compositor. It creates a virtual desktop and can upscale a game window. This can be beneficial if it doesn't play nicely with your desktop, if the window doesn't grab your mouse or if it breaks when loosing focus.

Setup

You can usually install Gamescope from your distribution official repository. To check if it's installed, run gamescope --help in a terminal emulator. To get a smooth gaming experience, run sudo setcap 'CAP_SYS_NICE=eip' $(which gamescope)[1].

Usage

To run Gamescope with your game, you just have to append your binary path. So, if you use Wine from the command-line and want to limit a game to 30 FPS use gamescope -r 30 -- wine game.exe[2]. While you can use the command prefix field on launchers like Lutris or Bottles, Gamescope should have its own sections with multiple options available.

Keyboard shortcuts[3]

  • Super + F: Toggle fullscreen
  • Super + N: Toggle nearest neighbour filtering
  • Super + U: Toggle FSR upscaling
  • Super + Y: Toggle NIS upscaling
  • Super + I: Increase FSR sharpness by 1
  • Super + O: Decrease FSR sharpness by 1
  • Super + S: Take screenshot (goes to /tmp/gamescope_$DATE.png)
  • Super + G: Toggle keyboard grab

Upscaling

Gamescope can be used for upscaling with AMD FidelityFX™ Super Resolution or NVIDIA Image Scaling: set gamescope -F fsr --sharpness 4 -- %command% or gamescope -F nis --sharpness 4 -- %command% as a command prefix. "4" is an example value, replace it by something between "0" and "20". This also works for native games and can also be used with another resolution: gamescope -w 1920 -h 1080 -W 3840 -H 2160 -F nis --sharpness 4 -- game[4].

Downsampling

You can use Gamescope for downsampling too. For example, use gamescope -f -w 3840 -h 2160 -- %command% as a command prefix, to downscale from 4K. The same can be achieved in Lutris by enabling Gamescope and setting "3840x2160" as resolution.

Troubleshooting

  • If you experience stuttering and lag, try running gamescope --rt -r <desired_framerate> --immediate-flips -- %command% where <desired_framerate> is a number.
  • Some games have issues like video playblack or black/white screens when the environment variable ENABLE_GAMESCOPE_WSI is set to "1": use ENABLE_GAMESCOPE_WSI=0 to fix them[5].
  • Shortcuts might not work on GNOME[6] but they can be fixed by unchecking the "Gamescope" option in the Lutris settings and using the command prefix field.
  • If you run a game from Steam with Gamescope, you could experience stuttering after 30 minutes[7].
  • If you need to use MangoHud with Gamescope, don't chain both commands but use the --mangoapp argument with Gamescope[8].
  1. ↑ https://wiki.archlinux.org/title/Gamescope#Setting_Gamescopes_priority
  2. ↑ https://github.com/ValveSoftware/gamescope#examples
  3. ↑ https://github.com/ValveSoftware/gamescope#keyboard-shortcuts
  4. ↑ https://wiki.archlinux.org/title/Gamescope#Upscaling
  5. ↑ https://github.com/ValveSoftware/gamescope/issues/1182
  6. ↑ https://github.com/ValveSoftware/gamescope/issues/424
  7. ↑ https://wiki.archlinux.org/title/Gamescope#Launching_gamescope_from_Steam,_stuttering_after_~24_minutes_(Gamescope_Lag_Bomb)
  8. ↑ https://github.com/flightlessmango/MangoHud#gamescope
Retrieved from "https://linux-gaming.kwindu.eu/index.php?title=Gamescope&oldid=2277"