Fedora Atomic#

This documentation applies to both Fedora’s Atomic images (Silverblue, Kinoite, etc.), and Universal Blue images (Bazzite, Bluefin, etc.).

Standalone Headsets: WiVRn#

To stream to standalone headsets on Fedora Atomic Desktops, check out WiVRn.

PVCR Headsets: Envision#

This is a temporary guide on running wired VR headsets with the FOSS VR stack on Fedora Atomic distros. We’re still working on a full guide.

For wired (ie. not standalone) VR, install Envision.

If you do not need a custom branch of Monado, for well-supported headsets, install Monado with rpm-ostree and use Envision’s system profile.

If you do need a custom branch of Monado, for headsets or other hardware not yet fully supported upstream, use Envision’s development profiles; run Envision inside an up-to-date Fedora Distrobox, install the build dependencies Envision asks for, build the appropriate development profile inside the container, resulting in a build of Monado and xrizer, then exit the container, give the capabilities to the Monado binary (run sudo setcap CAP_SYS_NICE=eip path/to/monado-service outside the container), then run Envision (outside the container).

You can substitute the Envision AppImage in place of the rpm-ostree package, if you see Fedora’s packaging of Envision has fallen out-of-date.

Do not run monado-service (nor click the Start button in Envision) inside a Distrobox, or any container, if you can help it - it will fail to acquire a realtime queue/CAP_SYS_NICE which is necessary to do reprojection (jitter prevention). That being said, building dev profiles in a Distrobox can work, as explained above, as long as you end up running the resulting binary outside the container. Build stuff inside the Distrobox, and run them outside.

In order for a Distrobox to build software that the host OS can also run, pick the Distrobox image that is binary-compatible with your host OS: e.g. For Bazzite 45, make a Distrobox from the quay.io/fedora/fedora:45 image.

Or, you can build Monado from source yourself, install it, and use Envision’s system profile to run it.

The old way to set up Fedora Atomic for wired VR was with Homebrew-XR’s distribution of Envision, but Homebrew-XR is no longer maintained.

Plugins & Overlays#

To install FOSS VR plugins and overlays, most are available via AppImages for each. To get them to show up in WiVRn or Envision’s lists of plugins, read Envision#Plugins via AppImages. The information in that page applies to both.

The old way to install plugins, overlays, and other VR software was to install them from Homebrew-XR, after which they would automatically show up as plugins in WiVRn or Envision, but Homebrew-XR is no longer maintained.