andrei/niri
1
0
Fork 0
mirror of https://github.com/niri-wm/niri.git synced 2026-06-21 02:01:55 +07:00
Code Issues Packages Projects Releases 10 Wiki Activity

wiki/Xwayland: Clarify xwayland-satellite

Browse Source
This commit is contained in:
Ivan Molodetskikh
2025-01-03 10:21:06 +03:00
parent c17d4dc050
commit 0224452cef
1 changed files with 11 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
wiki/Xwayland.md
+11 -5
View File
@@ -3,21 +3,27 @@ However, there are multiple solutions to running X11 apps in niri.
## Using xwayland-satellite
[xwayland-satellite] is a new project that essentially implements rootless Xwayland in a separate application, without the host compositor's involvement.
[xwayland-satellite] implements rootless Xwayland in a separate application, without the host compositor's involvement.
It makes X11 windows appear as normal windows, just like a native Xwayland integration.
While it is still somewhat experimental, it handles a lot of applications correctly, like Steam, games and Discord.
Build it according to instructions from its README, then run the `xwayland-satellite` binary.
Now you can start X11 applications on the X11 DISPLAY that it provides:
Install it from your package manager, or build it according to instructions from its README, then run the `xwayland-satellite` binary.
Look for a log message like: `Connected to Xwayland on :0`.
Now you can start X11 applications on this X11 DISPLAY:
```
env DISPLAY=:0 flatpak run com.valvesoftware.Steam
```
They will appear as normal windows.
![xwayland-satellite running Steam and Half-Life.](https://github.com/user-attachments/assets/57db8f96-40d4-4621-a389-373c169349a4)
You can also set `DISPLAY` by default for all apps by adding it to the `environment` section of the niri config:
You can also automatically run it at startup, and set `DISPLAY` by default for all apps by adding it to the `environment` section of the niri config:
```kdl
spawn-at-startup "xwayland-satellite"
// Or, if you built it by hand:
// spawn-at-startup "~/path/to/code/target/release/xwayland-satellite"
environment {
DISPLAY ":0"
}