ALVR - Air Light VR

Stream VR games from your PC to your headset via Wi-Fi.
ALVR uses technologies like Asynchronous Timewarp and Fixed Foveated Rendering for a smoother experience.
All games that work with an Oculus Rift (s) should work with ALVR.
This is a fork of ALVR.

Headset	Support
Oculus Quest	✔️
Oculus Quest 2	✔️
Oculus Go	✔️ (no controller)
GearVR	❌ (use this)

Requirements

Oculus Quest, Oculus Quest 2 or Oculus Go on the latest firmware
SteamVR
High-end gaming PC
- Windows 10 May 2020 update is recommended. If you are on an older version, you need to install Chrome or another Chromium based browser.
- Minimum supported OS version is Windows 8.
- NVIDIA GPU that supports NVENC (Supported GPUs) (or with an AMD GPU that supports AMF VCE) with the latest driver.
- Laptops with an onboard (Intel HD, AMD iGPU) and an additional dedicated GPU (NVidia GTX/RTX, AMD HD/R5/R7): you should assign the dedicated GPU or "high performance graphics adapter" to the applications ALVR, SteamVR for best performance and compatibility. (NVidia: Nvidia control panel->3d settings->application settings; AMD: similiar way)
802.11ac 5Ghz wireless or ethernet wired connection
- It is recommended to use 802.11ac 5Ghz for the headset and ethernet for PC
- You need to connect both the PC and the headset to same router (or use a routed connection as described here)

Install

It is recommended (but not mandatory) to uninstall any other VR streaming software on your PC, including older versions of ALVR. If you didn't already, install SteamVR, launch it and then close it (this is to make sure SteamVR executes its first time setup).

To install ALVR download and execute ALVR_Installer_vX.X.X.exe from the releases page. An entry will appear in the Start menu. The first time you open ALVR Launcher.exe you may have to allow it in the SmartScreen prompt. In the release page you can also find the portable version alvr_server_windows.zip. If you already have ALVR v13.1.0 or greater you can upgrade with the autoupdater.

Install the client on your headset through Sidequest (Quest version, Go version). To make the Oculus Quest microphone work you need to install the VB-CABLE Virtual Audio Device.

Nightly versions

You can install the latest untested server version from the nightly releases page.

The nightly client app can be installed from Sidequest (Quest version, Go version) (it needs to be updated for each server update).

Usage

Open ALVR Launcher.exe (ALVR dashboard). The first time a setup wizard will guide you through the installation. Oculus Go users should import the oculus_go_preset.json found the in the installation folder.
Launch ALVR on your headset. While the headset screen is on, click Trust next to the client entry (on the PC) to start streaming.
To change settings, open the dashboard on the headset with a long press of the menu button (on the left controller), change what you want and then press Restart SteamVR. The current playing game could shutdown so any unsaved progress could be lost.
To shutdown ALVR you need to close both the ALVR dashboard on PC and SteamVR.
If you want play games without launching the ALVR dashboard first, you need to register the driver. Go to Installation tab, then click on Register ALVR driver. This is normally discouraged because it can cause problems with other SteamVR drivers (for example the Oculus Link).

IMPORTANT: SteamVR must be always running, otherwise the dashboard will not save settings and the client will not connect.

Notes

You can access ALVR dashboard from your smartphone. On the browser you need to type the local IP of your PC followed by :8082 (for example: 192.168.0.3:8082 ).

Troubleshooting

To reset ALVR, delete the file session.json from the installation folder.
Please check the Troubleshooting page. The original repository wiki can also help.
You can find some setup advice here.

Uninstall

Open ALVR Launcher.exe, go to Installation tab then press Remove firewall rules. Close ALVR window and delete the ALVR folder.

If you have a version prior to v12.0 you need to launch remove_firewall_rules.bat and driver_uninstall.bat in the installation folder.

Build from source

Preferred IDE (optional): Visual Studio Code with rust-analyzer extension

Common requisites

Install LLVM
Install rustup
Download this repository

Build server

Install the MSVC compiler (for example installing C++ build tools with Visual Studio)
On the repository root execute:
```
cargo xtask build-server --release
```
ALVR server will be built into /build/alvr_server_windows.

Build client

Install Python
Install Android Studio >=4.0, API Level 30. Requires latest LLDB and NDK packages.
Set the environment variable JAVA_HOME to C:\Program Files\Android\Android Studio\jre.
Set the environment variable ANDROID_SDK_ROOT to %LOCALAPPDATA%\Android\Sdk.

On the repository root execute:

rustup target add aarch64-linux-android
cargo xtask build-client --release

ALVR client will be built into /build.

Note: After doing the above steps, you can debug the client normally by opening the Android Studio project at alvr/client/android.

Linux experimental build

Instructions to build ALVR on Linux. Only the webserver works, there is no SteamVR integration. Tested on Ubuntu 18.04

Install OpenSSL (libssl-dev), ALSA (libasound2-dev), GTK (libgtk-3-dev).
On the repository root execute:
```
cargo xtask build-server --release
```
ALVR server will be built into /build/alvr_server_linux.

License

ALVR is licensed under the MIT License.

Donate

If you want to support this project you can make a donation to our Open Source Collective account.

You can also donate to the original author of ALVR using Paypal (polygraphene@gmail.com) or with bitcoin (1FCbmFVSjsmpnAj6oLx2EhnzQzzhyxTLEv).

nfl0 / ALVR