Skip to content

Installation

Jump to bottom
Lasse15 edited this page Sep 14, 2021 · 11 revisions

Basic installation

PC side:

  • Install SteamVR, launch it once then close it. This is to make sure it sets the environment correctly for ALVR.
  • Go to the latest release download page. In the "Assets" section at the bottom download the ALVR Installer.
  • Run the installer. If prompted, allow the execution in the SmartScreen popup. You need to give administrator permissions to install ALVR. For best compatibility do not change the installation folder.
  • Once the installation finished, launch ALVR. You are greeted with a setup wizard. Follow the setup to set the firewall rules and presets.

If you have problems launching ALVR, follow the guide below to use the portable version

Headset side:

  • Install SideQuest on your PC and enable developer mode on the headset. You can follow this guide.
  • Connect your headset to Sidequest. If you have an Oculus Quest 1/2 download the ALVR app here, if you have an Oculus Go download it here

Usage

Launch ALVR on your headset. While the headset screen is on, click Trust next to the client entry on the PC app to start streaming. Next time the stream will start automatically.

For any problem visit the troubleshooting page.

Advanced installation

Portable version

There is also a portable version for the PC that requires more manual steps to make it work.

  • Install SteamVR and launch it once.
  • Download alvr_server_windows.zip from the latest release download page.
  • Unzip into a path that contains only ASCII characters and has edit permissions without administrator rights.

Prereleases

If you want to get new features early or you want to help with testing you can install a prerelease version.

You can download the latest beta release here.
You can download the latest nightly/alpha release here.

You can install the nightly app for your headset from Sidequest (Quest version, Go version).

Since nightly releases can be unstable, for maximum compatibility always use matching versions for PC and headset. They are updated once a day.

Microphone streaming

To use the microphone you need to install the VB-CABLE driver. Set "CABLE Output" as the default microphone. Then you can enable the microphone in the ALVR setting, leave "Virtual microphone input" to Default.

Connect headset and PC on separate networks

Check out the guide here.

Use ALVR together with third-party drivers

By default ALVR disables other SteamVR drivers before starting. Among these drivers there is Driver4VR for full body tracking. ALVR disables these drivers to maximize compatibility with every PC setup. You can disable this behavior by manually registering the ALVR driver. Go to the Installation tab and click on Register ALVR driver. The next time you launch ALVR you will be able to use the other drivers concurrently.

Launch ALVR together with SteamVR

You can skip the ALVR Launcher and open ALVR automatically together with SteamVR. Open ALVR, go to the Installation tab and click on Register ALVR driver.

Use a browser different than Chrome

ALVR requires a Chromium based browser to correctly display the dashboard. Chrome and Edge work out of the box, but Edge has a few bugs that make ALVR behave weirdly. If you want to use other Chromium based browsers like Brave or Vivaldi you have to add an environment variable ALCRO_BROWSER_PATH pointing to the path of the browser executable (for example C:\Program Files\Vivaldi\Application\vivaldi.exe). Unfortunately Firefox is not supported.

Connect headset and PC via a USB Cable

Check out the guide here.

Linux experimental build (PC side, Ubuntu 20.04)

Warning: These instructions are not officially supported, you may have better luck following this page.

Some settings are required:

  • Foveated encoding: OFF
  • Color correction: OFF
  • Game audio: OFF
  • Microphone: OFF
  • Streaming protocol: UDP (TCP also worked for some people)

If you do not install the correct version of FFmpeg systemwide, a common problem is the server crashing or failing to show images on the headset because SteamVR loads the wrong version of FFmpeg.

One of the solution is find out the path where you installed the new FFmpeg, and open two terminal and run export LD_PATH_LIBRARY=/path/to/new/FFmpeg:$LD_PATH_LIBRARY(eg: export LD_PATH_LIBRARY=/usr/local/lib:$LD_PATH_LIBRARY). Then run steam and alvr in the two terminals respectively.

Clone this wiki locally