Skip to content

ALVR wired setup (ALVR over USB)

GitHub Action edited this page Feb 4, 2024 · 10 revisions

ALVR Configuration

ALVR Client (Headset):

  • WiFi must be turned on and connected, otherwise ALVR will not search for the streamer.

ALVR Streamer (PC):

  • If your headset is detected, click "Trust." Click "Edit", "Add new" and change the IP address to 127.0.0.1.
  • If your headset is not detected, click "Add client manually" and use the IP address 127.0.0.1. Use the hostname displayed on your headset screen.
  • Switch the connection streaming protocol to TCP in Settings > Connection.

Letting your PC communicate with your HMD

The Quest, Pico HMDs are Android devices, therefore, we can use Android Device Bridge commands to tell the HMDs to look for data over USB, as well as Wi-Fi, using port forwarding.

You can accomplish this with some pre-made applications/scripts (just below), or run the commands manually with SideQuest

If you haven't already, connect a USB cable from your PC to your headset. USB 2.0 will work fine but 3.0 and higher is best. Make sure to authorize the computer in your headset.

Option 1 - Dedicated ADB Applications

The following programs serve to wrap and simplify the process of doing manual ADB commands, the first two will also automatically reconnect the headset if the USB connection is interrupted.

  • ADBForwarder (Recommended)

    • Easy to use
    • Downloads ADB for you
    • Cross-platform (Windows & Linux)
  • Python Script

    • Lightweight and simple
    • Requires Python 3 and PyWin32
    • Requires ADB Platform Tools to be in the same directory as main.py
      • Just extract platform-tools to your desktop and place main.py in that folder, should work when you run the script
  • Batch Script

    • Requires ADB Platform Tools, edit the path in line 2 to point to the directory where you extracted platform-tools
    • Needs to be run every time you (re)connect your headset

Option 2 - SideQuest:

  • Ensure SideQuest is running, and the headset has authorized the USB connection to the PC
  • Open the 'Run ADB Commands' menu in SideQuest (top-right, box with an arrow inside it)
  • Click 'Custom Command' and run these adb commands:
    • adb forward tcp:9943 tcp:9943
    • adb forward tcp:9944 tcp:9944
    • These commands will need to be run every time you (re)connect your headset.
  • Keep SideQuest opened until you want to close the connection.

Once you are finished, the headset should now establish a connection over USB.