Note: Updated KWin versions from PPAs like "Kubuntu Backports" might be incompatible with the plugin from this PPA and will not even attempt to load it. With such a configuration, at least kwin-effect-xrdesktop will have to be built from source.
xrdesktop can run on Valve's SteamVR via the OpenVR API as well as any OpenXR runtime (specifically tested is the "Monado" runtime) via the OpenXR API. This support is implemented as backend libraries for gxr.
To run xrdesktop on OpenVR/SteamVR, install the OpenVR backend:
In the following sections, remove the -git suffixes to build the stable version of xrdesktop. Note that the stable AUR packages are maintained by a volunteer not affiliated with Collabora.
Unlike the ubuntu package, the gxr package depends on openvr and openxr headers. Both backends will be built and installed.
KWin will be automatically installed by this command and can be run standalone. To make use of the plasma applet, plasmashell should be installed.
yay -S kwin-effect-xrdesktop-git kdeplasma-applets-xrdesktop-git
yay -S gnome-shell-xrdesktop-git gnome-shell-extension-xrdesktop-git
If you just installed xrdesktop and have not restarted kwin yet, do so now, for example in krunner (Alt + F2):
KWin configuration: Disable blocking of compositing
The xrdesktop KWin effect can only work and mirror thed esktop windows to VR when OpenGL compositing is used. KDE disables desktop effects by default when a full screen application with graphics is running. This is also the case when running SteamVR.
This option should be unchecked in systemsettings5:
'Display and Monitor" -> "Compositor" -> Checkbox: "Allow applications to block compositing"
Add xrdesktop plasma applet to desktop
Right click on desktop or any panel and activate Unlock Widgets if necessary.
Cick on the panel configuration menu or right click on desktop and choose Add widgets.
Scroll to bottom and drag XR Desktop Switch to the desktop or a panel.
Start xrdesktop on KWin
Activate xrdestkop in the plasma applet.
Alternatively you can also run the following qdbus command
If you just installed xrdesktop and have not restarted gnome-shell yet, do so now:
Press Alt + F2 to open the command window.
Type r and Enter to reload GNOME Shell.
Enable xrdesktop gnome-shell extension
Install gnome-tweaks if you did not already.
Press the Super key, type and open Tweaks.
Go to the Extensions tab.
Enable the xrdesktop extension.
Start xrdesktop on gnome-shell
Enable Mirror to XR in the xrdesktop extension.
Alternatively you can also run the following script, which is included in gnome-shell-xrdesktop
The xrdesktop package includes a dedicated settings UI named xrdesktop Settings in the menu or /usr/bin/xrd-settings.
Alternatively a "raw" view of the settings can be used with the dconf-editor gnome tool. To jump right to the xrdesktop settings use the /org/xrdesktop namespace as parameter start it as dconf-editor /org/xrdesktop.
Individual settings can also be set with the gsettings command line tool. For example:
gsettings set org.xrdesktop always-show-overlay-pointer false
All settings should apply immediately to a running xrdesktop session.
KWin plugin not working
Running kwin_x11 --replace in a terminal will immediately (without starting xrdesktop) print this message if the plugin could be found and loaded:
Initializing xrdesktop plugin successful.
If it does not, ensure KWin desktop effect is enabled
Open Desktop Effects settings (Available in the Application menu or in System Settings - Desktop Behavior)
Ensure the XR Desktop effect is enabled (it should be enabled by default)
Make sure you don't filter the effects:
Running kwin_x11 --replace from a terminal will also print various debugging messages to stdout while running xrdesktop.