aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSalman Farooq <46742354+SalmanFarooqShiekh@users.noreply.github.com>2024-06-29 09:18:29 +0500
committerGitHub <noreply@github.com>2024-06-28 21:18:29 -0700
commit747c18629346b46c7a6f6dcc85c4c0cf3b17d9d4 (patch)
treef809c1490349a4eeceeee6302b37601c222584fd
parentbdf9894020f184643ac98fbbc74402689edfe3f4 (diff)
downloadniri-747c18629346b46c7a6f6dcc85c4c0cf3b17d9d4.tar.gz
niri-747c18629346b46c7a6f6dcc85c4c0cf3b17d9d4.tar.bz2
niri-747c18629346b46c7a6f6dcc85c4c0cf3b17d9d4.zip
add-in-wiki-xwayland-run-as-a-solution-to-run-X-apps (#477)
-rw-r--r--wiki/Xwayland.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/wiki/Xwayland.md b/wiki/Xwayland.md
index 2b3496bd..14e401ae 100644
--- a/wiki/Xwayland.md
+++ b/wiki/Xwayland.md
@@ -37,6 +37,24 @@ binds {
}
```
+## Using xwayland-run to run Xwayland
+
+[xwayland-run] is a helper utility to run an X11 client within a dedicated Xwayland rootful server.
+It takes care of starting Xwayland, setting the X11 DISPLAY environment variable, setting up xauth and running the specified X11 client using the newly started Xwayland instance.
+When the X11 client terminates, xwayland-run will automatically close the dedicated Xwayland server.
+
+It works like this:
+
+```
+xwayland-run <Xwayland arguments> -- your-x11-app <X11 app arguments>
+```
+
+For example:
+
+```
+xwayland-run -geometry 800x600 -fullscreen -- wine wingame.exe
+```
+
## Using the Cage Wayland compositor
It is also possible to run the X11 application in [Cage](https://github.com/cage-kiosk/cage), which runs a nested Wayland session which also supports Xwayland, where the X11 application can run in.
@@ -95,4 +113,5 @@ env DISPLAY=:0 flatpak run com.valvesoftware.Steam
They will appear as normal windows.
+[xwayland-run]: https://gitlab.freedesktop.org/ofourdan/xwayland-run
[xwayland-satellite]: https://github.com/Supreeeme/xwayland-satellite