|
|
# xrdesktop on OpenXR
|
|
|
|
|
|
Starting from 0.16, xrdesktop supports *only* OpenXR.
|
|
|
|
|
|
## OpenXR Loader
|
|
|
|
|
|
Regardless of which runtime is used, for xrdesktop to run with OpenXR, the OpenXR loader always has to be installed.
|
|
|
|
|
|
See the OpenXR Loader section of the [Monado Getting Started Guide](https://monado.freedesktop.org/getting-started.html) for more information.
|
|
|
|
|
|
## gxr and xrdesktop settings
|
|
|
## gxr and xrdesktop settings (legacy branch only)
|
|
|
|
|
|
Make sure your `gxr` build has been compiled with openxr support and that the openxr backend (`libgxr-openxr.so`) is installed.
|
|
|
For the legacy branch: Make sure your `gxr` build has been compiled with OpenXR support.
|
|
|
|
|
|
If gxr was built with OpenVR support (this usually includes distribution packages, even if the OpenVR backend is not installed), OpenVR will be the default backend and needs to be changed to OpenXR via the included `xrd-settings` GUI application or with gsettings directly. Since overlay mode is not yet implemented for OpenXR, `xrd-settings` will make sure to default to scene mode. When using gsettings, you will need to set the default mode to scene.
|
|
|
If gxr was built with OpenVR support OpenVR will be the default backend and needs to be changed to OpenXR via the included `xrd-settings` GUI application or with gsettings directly. Since overlay mode is not yet implemented for OpenXR, `xrd-settings` will make sure to default to scene mode. When using gsettings, you will need to set the default mode to scene.
|
|
|
|
|
|
gsettings set org.xrdesktop default-api openxr
|
|
|
gsettings set org.xrdesktop default-mode scene
|
|
|
|
|
|
It is possible to override this setting with an environment variable: `GXR_API=openxr kwin_x11 --replace` or `GXR_API=openvr kwin_x11 --replace`.
|
|
|
|
|
|
For 0.16 and later: OpenXR support is a hard requirement to build gxr and the above configuration does not exist anymore.
|
|
|
|
|
|
## OpenXR runtimes
|
|
|
|
|
|
At this time the only viable OpenXR runtimes for Linux are Collabora's "Monado" runtime and SteamVR Beta.
|
... | ... | |