/ALVR

ALVR is an open source remote VR display for Gear VR and Oculus Go. With it, you can play SteamVR games in your standalone headset.

Primary LanguageC++MIT LicenseMIT

ALVR - Air Light VR

ALVR is an open source remote VR display for Gear VR and Oculus Go. With it, you can play SteamVR games in your standalone headset.

English | Japanese

Description

ALVR streams VR display output from your PC to Gear VR / Oculus Go via Wi-Fi. This is similar to Riftcat or Trinus VR, but our purpose is optimization for Gear VR. ALVR provides smooth head-tracking compared to other apps in a Wi-Fi environment using Asynchronous Timewarp.

Now, we have Gear VR / Oculus Go Controller support!

Note that many PCVR games require 6DoF controller or multiple buttons, so you might not able to play those games. You can find playable games in List of tested VR games and experiences.

Requirements

ALVR requires any of the following devices:

  • Gear VR
  • Oculus Go
Device Working?
Oculus Go OK
GalaxyS9/S9+ OK
GalaxyS8/S8+ OK
GalaxyS7 OK
GalaxyS6(Edge) OK
  • High-end gaming PC with NVIDIA GPU which supports NVENC
    • Only Windows 10 is supported
  • 802.11n/ac wireless or ethernet wired connection
    • It is recommended to use 802.11ac for the headset and ethernet for PC
      • You need to connect both to the same router
  • SteamVR

Installation

Install ALVR server for PC

  • Install SteamVR
  • Install vc_redist.x64.exe from here
  • Download the zip from Releases
  • Extract the zip to any folder
  • Launch ALVR.exe

Install ALVR client for headset

From Oculus Store

  • You can download ALVR Client from Oculus Store with key.
  • Open the key distribution page on your smartphone and follow the instruction.

Download from GitHub for Gear VR (optional)

  • (Install apk from SideloadVR) Yet to be released. Please wait.
  • Get osig file from oculus website
  • Install Apk Editor
  • Download apk from Releases
  • Open apk and put osig file on assets folder
  • Build and install

Download from GitHub for Oculus Go (optional)

  • Download apk from Releases
  • Install apk via adb

Usage

  • Launch ALVR.exe
  • Press "Start Server" button or launch VR game
  • SteamVR's small window will appear
  • Launch ALVR Client in your headset
  • IP Address of headset will appear in the server tab of ALVR.exe
  • Press "Connect" button

Troubleshoot

  • "Server is down" is displayed on right top corner on ALVR.exe
    • Retry execute driver_install.bat on driver folder
    • Terminate the process vrserver.exe on Task Manager
  • IP Address is not displayed on ALVR.exe
    • It maybe a network issue
    • Confirm that the headset and PC are connected in the same LAN
    • Check the firewall settings (Permit UDP/9944 port)
    • If you can use adb, run adb shell ping -c 5 (IP Address of PC) then check success of ping
  • Bad streaming quality (sometimes stops, laggy or broken picture)
    • We will add the functionality to change streaming resolution and bitrate
    • Connect with 5GHz 802.ac Wi-Fi or Connect wired LAN to headset
  • If you get "A key component of Steam VR isn't working properly" error
    • Check if the graphic driver is updated

Uninstallation

  • Execute driver_uninstall.bat in the driver folder
  • Delete the install folder (ALVR does not use the registry)
  • If you already deleted the folder without executing driver_uninstall.bat:
    • Open C:\Users\%USERNAME%\AppData\Local\openvr\openvrpaths.vrpath and check install directory
    • Execute "C:\Program Files (x86)\Steam\steamapps\common\SteamVR\bin\win32\vrpathreg.exe" removedriver (install folder) in Command Prompt

Future work

  • Support streaming sound
  • Support H.265 hevc encoding (currently H.264 only)
  • Better installer

Build

ALVR Server and GUI (Launcher)

  • Open ALVR.sln with Visual Studio 2017 and build
    • alvr_server project is the driver for SteamVR written in C++
    • ALVR project is the launcher GUI written in C#

ALVR Client

  • Clone ALVR Client
  • Put your osig file on assets folder (only for Gear VR)
  • Build with Android Studio
  • Install apk via adb

License

ALVR is licensed under MIT License.

Donate

If you like this project, please donate!

Donate by paypal

Donate If you could not use this link, please try the following.

  1. Login your paypal account
  2. Open "Send and request" tab
  3. Click "Pay for goods or services"
  4. Put "polygraphene@gmail.com" (it is my paypal account) and click next

Donate by bitcoin

bitcoin:1FCbmFVSjsmpnAj6oLx2EhnzQzzhyxTLEv