diff options
| -rw-r--r-- | wiki/Xwayland.md | 16 |
1 files changed, 11 insertions, 5 deletions
diff --git a/wiki/Xwayland.md b/wiki/Xwayland.md index b915239f..658b6a99 100644 --- a/wiki/Xwayland.md +++ b/wiki/Xwayland.md @@ -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. + -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" } |