Skip to content

Streaming from the Meta Quest Headset (with Pass-Through)

  1. First-time connection

    • Plug the headset into your PC via USB.
    • You must repeat this step after a headset restart or if ADB is used from another PC.
  2. Download the toolset (Windows or macOS)

    https://drive.google.com/drive/folders/1Lg8_UuqdL684hmial2fm_BOh2-wS1RZq?usp=sharing

  3. Set headset IP address

    • On the headset: Settings > Wi-Fi > (your connected network) > Scroll down > IP address
    • In the downloaded folder, open Headsets_IP_Address.txt and:
      • Enter the headset IP address (you can add multiple, but start with just one).
      • Use # to comment out addresses you don’t need.
      • Save the file.

    image.png

  4. Run the provided scripts (double-click or drag into Terminal on macOS):

    • Quest_streaming

      • Lets you choose resolution (1920p or 1280p).

        image.png

      • Recommended and most performant method.

      • Supports streaming from up to 8 headsets simultaneously.

      • Captures both eyes view.

      • Use OBS (or other software) to crop and broadcast the feed.

        cRxCxyLnkz.png

    • Quest_streaming_cropped

      • Uses included ffplay library to crop the image (showing only one eye).
      • Much less performant.
      • Not recommended for more than 2 simultaneous streams (depends on PC performance).

      ffplay_KxSzTL8cOI.jpg


  1. Put on your headset.
  2. Open Settings > System > Developer.
  3. Enable USB Debugging.
    • If you haven’t already, you’ll need to enable Developer Mode in the Meta Quest mobile app first.
  1. Connect your Meta Quest to the PC via USB-C.
  2. The headset will show a “Allow USB Debugging?” prompt — select Always allow from this computer and confirm.
  3. Find your headset IP address (Settings > WiFi > scroll down to IP Address)
  4. Connect your headset with USB cable to your PC
  5. Accept the “Allow USB debugging” prompt inside the headset - Always allow
  6. Run command: adb tcpip 5555
  7. Disconnect the USB cable
  8. adb connect IP_ADDRESS:5555
  9. If you get cannot connect error
    1. adb kill-server
    2. adb tcpip 5555
    3. try adb connect again
  10. It might ask for permission on the headset again
  11. Then it should say: connected to IP_ADDRESS:5555
  12. run scrcpy -s IP_ADDRESS:5555
    1. if your download folder of scrcpy is C:\scrcpy-win64-v3.3.1\scrcpy.exe run it as C:\scrcpy-win64-v3.3.1\scrcpy.exe -s IP_ADDRESS:5555
    2. similarly on macOS /DOWNLOAD_PATH/scrcpy-macos-aarch64-v3.3.1/scrcpy -s IP_ADDRESS:5555
    3. you can run it directly without the inserting the full path if you add scrcpy to to your common paths
    4. it works also without ip address, but you can use it to connect to multiple headsets

SCRCPY parameters

  • —video-bit-rate=20M
  • —max-size=1920
  • —max-fps=30

ADB commands

  • adb kill-server
  • adb tcpip 5555
  • adb connect IP_ADDRESS

Cropped version (stream)

  • windows
  • macOS:
    • /tmp/scrcpy.mkv is a record path

      scrcpy --video-codec=h264 --no-playback --max-size 4128 --record /tmp/scrcpy.mkv --record-format=mkv & \ ffplay -probesize 1M -analyzeduration 0 -fflags nobuffer -flags low_delay -i /tmp/scrcpy.mkv -vf "crop=iw/2:ih:iw/2:0,scale=-2:1080"