mirror of
https://github.com/hyprwm/hyprland-wiki.git
synced 2024-11-05 21:15:58 +01:00
46 lines
1.4 KiB
Markdown
46 lines
1.4 KiB
Markdown
|
Screen tearing is used to reduce latency and/or jitter in games.
|
||
|
|
|
||
|
|
## Enabling tearing
|
||
|
|
|
||
|
|
To enable tearing:
|
||
|
|
- Set `general:allow_tearing` to `true`. This is a "master toggle"
|
||
|
|
- Add `env = WLR_DRM_NO_ATOMIC,1` to your Hyprland config. This disables the usage of a newer DRM API that doesn't support tearing yet.
|
||
|
|
- Add an `immediate` windowrule to your game of choice. This makes sure that Hyprland will tear it.
|
||
|
|
|
||
|
|
{{< hint type=note >}}
|
||
|
|
Please note that tearing will only be in effect when the game is in fullscreen and the only thing visible on the screen.
|
||
|
|
{{< /hint >}}
|
||
|
|
|
||
|
|
Example snippet:
|
||
|
|
```env
|
||
|
|
general {
|
||
|
|
allow_tearing = true
|
||
|
|
}
|
||
|
|
|
||
|
|
env = WLR_DRM_NO_ATOMIC,1
|
||
|
|
|
||
|
|
windowrulev2 = immediate, class:^(cs2)$
|
||
|
|
```
|
||
|
|
|
||
|
|
{{< hint type=warning >}}
|
||
|
|
If you experience graphical issues, you may be out of luck. Tearing support is experimental.
|
||
|
|
|
||
|
|
See the likely culprits below.
|
||
|
|
{{< /hint >}}
|
||
|
|
|
||
|
|
## Common issues
|
||
|
|
|
||
|
|
### Graphical artifacts (random colorful pixels, etc)
|
||
|
|
Likely issue with your graphics driver. Please note, afaik, intel's iGPUs do not support tearing at all.
|
||
|
|
|
||
|
|
Please _do not_ report issues if this is the culprit. Unfortunately, it's most likely your GPU driver's fault.
|
||
|
|
|
||
|
|
Could be the below as well
|
||
|
|
|
||
|
|
### Other graphical issues
|
||
|
|
Likely issue with `WLR_DRM_NO_ATOMIC`.
|
||
|
|
|
||
|
|
NO_ATOMIC forces the use of a legacy, less tested drm API.
|
||
|
|
|
||
|
|
Please _do not_ report issues if this is the culprit. Unfortunately, you will have to wait for the Linux kernel to support
|
||
|
|
tearing page flips on the atomic API.
|