WiVRn

Access your PC VR applications from a standalone headset

About

Get started

Install the dashboard on your computer

The dashboard is available on Flathub:

Get it on Flathub

A wivrn-dashboard package is available on AUR:

yay -S wivrn-dashboard

In order to run OpenVR or any Steam game, a compatibility library such as opencomposite or xrizer is also needed:

yay -S xrizer-git

A wivrn package is available in Fedora:

sudo dnf install wivrn

Note that patented codecs (H.264 and H.265) are not available by default on Fedora, you will have to install them from rpmfusion if you need to use such codecs.

A media-libs/wivrn package is available on Guru.

In order to run OpenVR or any Steam game, media-libs/xrizer or media-libs/opencomposite is also required.

Instructions for building the WiVRn dashboard from source are available on the GitHub repository.

Install the client on your headset

WiVRn is available on the Meta Store for Quest 2 / 3 / Pro. For other headsets, including the Quest 1, you will have to sideload it by following the connection wizard in the dashboard.

When you start the dashboard the first time, the connection wizard will help you install the client on your headset.

You can run it later by clicking the "Wizard" button in the dashboard.

Instructions for building the WiVRn headset app from source are available on the GitHub repository.

Connect your headset to your computer

  1. Start the WiVRn dashboard on your PC
  2. Start the WiVRn client on your headset

    On a Quest, if you did not install it from the Meta Store, it will be in the "Unknown Sources" section.

  3. Connect to your PC from your headset
  4. Start a VR application from your PC

Privacy

WiVRn does not collect any user data.

FAQ

My computer is not seen by the headset

If the server list is empty in the headset app:

  • Make sure your computer is connected on the same network as your headset.
  • Check that avahi is running with
    systemctl status avahi-daemon
    . If it is not, enable it with
    systemctl enable --now avahi-daemon
    .
  • If you have a firewall, check that port 5353(UDP) is open.

My headset does not connect to my computer

  • If you have a firewall, check that port 9757 (UDP and TCP) is open
  • The server and client must be the same version

I don't have any sound

  • When the headset is connected, an audio device is created but not set as default. It can be set as default in your desktop's sound parameters.
  • For microphone, you also have to enable it on headset as it requires a permission on the device. Simply click the microphone icon at the top of the main screen.

Steam games don't launch on the headset

  • Make sure that an OpenVR compatibility such as OpenComposite or xrizer is installed. The flatpak version includes both.
  • Copy the launch arguments listed in the dashboard in the Steam launch parameters for the game. If no launch parameters are shown in the WiVRn dashboard, then they are not needed.
  • When using flatpak Steam, additional permissions must be given for OpenXR files, see details in readme

Source code


Social