This document aims to help you install an .apk file containing VR lab software to your Oculus Quest and mirror your headset's display to your computer.

Prerequisites

This document assumes:

• You have an Oculus Quest or Quest 2 headset
• The headset is connected to your computer with a USB-C cable rated for rapid data transfer (e.g. the silver striped cable included with headsets loaned from the Physics Department)
• The headset has Developer Mode enabled (this is true for any headset borrowed from the Physics Department)
• Your computer is running Windows 10, Mac OS X or higher, o3r a modern incarnation of Linux

Software installation

Install scrcpy following the directions specific to your operating system here: https://github.com/Genymobile/scrcpy#get-the-app

If you're running Windows, unzip the file you downloaded to a place you'll remember.

Running scrcpy

If you're running Windows, complete these steps first:

1. Open Command Prompt from the start menu.

2. Navigate to the folder where scrcpy.exe is located. For example, if I unzipped the files to C:/Users/joeexotic/Documents/scrcpy, I would use the command

   cd C:/Users/joeexotic/Documents/scrcpy to navigate there in Command Prompt.

If you're not running Windows, just open a terminal window.

The command prompt / terminal window will be hereafter referred to as the console.

Now, ensure your Quest headset is plugged into your computer with the silver cable (data cable).

Run the command scrcpy in your console. Chances are, it will fail with some error message saying something about authentications or permissions. Put on the headset; there should be a window asking if you want to enable USB debugging. Click the box that says something along the lines of "always allow," then click the big blue "Allow" button.

Now restart scrcpy. If it hasn't quit on its own, you can kill it with Ctrl+C / Cmd+C. It should now work; you will see a window appear that shows a feed of your headset display when the headset is on: