4.5 KiB
sidebar_position
| sidebar_position |
|---|
| 3 |
Setup OpenXR Runtime
This guide will help you set up your VR or AR headset for use with Stardust. Although support for many headsets on Linux is still under active development, there are a number of good options available. If you already have OpenXR set up on your Linux distribution, head to the Full Installation page to get Stardust XR installed.
:::info If you want to try Stardust in a window on your existing device you can skip this step and checkout the Quick Start Guide. :::
Envision
:::note
We highly recommend using Envision, an easy to use GUI for utilizing Monado which is what you likely use if you have a wired headset. Envision also comes with WiVRn support for connecting to headsets like the Meta Quest wirelessly. :::
Check the hardware table (for Monado/WiVRn support) to ensure your hardware and headset are compatible. If you're using a Nvidia card, you'll need to install [proprietary drivers]((https://rpmfusion.org/Howto/NVIDIA). If you're using a modern Nvidia card on Fedora (with RPMFusion) or Ultramarine, this command will install the driver:
sudo dnf install akmod-nvidia
sudo akmods
# Wait for this to finish before rebooting, this may take up to 15 minutes
AMD graphic cards do not require additional drivers.
Fedora and derivatives (except Enterprise Linux)
:::info You will need the Terra repository, unless you have Ultramarine Linux or Bazzite. You can install it using this command:
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' terra-release
::: Then, install Envision using:
sudo dnf install envision
Arch Linux
For Arch Linux, Envision is available via the AUR. We suggest using an AUR helper, like Paru:
paru -S envision-xr-git
NixOS
On NixOS, it's generally easiest to follow the instructions at https://lvra.gitlab.io/docs/distros/nixos/ as Envision is currently unstable on NixOS and troubleshooting SteamVR can be tricky.
Other options for installation
You can also download the Envision AppImage. Once downloaded, unzip the archive, you should find a file named Envision-x86_64.AppImage. You can do this from the properties menu in your file manager, or run chmod +x Envision-x86_64.AppImage in your terminal.
Then double click the file to run it.
When you launch Envision, you will have to build a profile depending on what headset and setup you are using, check the Envision website for instructions specific to what you have. You can take a look at [this section] of our Meta Quest setup video for an example using WiVRn.
Once you have one of these options installed, a quick way to test it within the headset is by running the command xrgears and see if it works. xrgears is a demo that comes with Monado.
:::tip If you run into any problems during installation, the Meta Quest Walkthrough may contain information helpful in regards to dependencies, firewalls and drivers. :::
ALVR
Another option is ALVR, you can check the github repository for more information https://github.com/alvr-org/ALVR
SteamVR
If you'd like to use SteamVR, head on over to https://lvra.gitlab.io/docs/steamvr/, although it is not the recommended way to use VR within Linux due to current poor support.