ChimeraX docs icon

Tool: Send to Quest

This tool sends a scene to an Oculus Quest VR headset to be viewed by the LookSee application. See ChimeraX VR on standalone Quest headsets for how to install LookSee on a Quest 2 or Quest Pro headset. See also: ChimeraX virtual reality

The scene must be simple enough for the Quest 2 or Quest Pro graphics to handle without flickering. If the room is shown (with pass-through video) the scene should have <700,000 triangles, and with room not shown (black background) <900,000 triangles.

In the LookSee app, clicking the A or X hand-controller button will show the user interface, and clicking “Open new files” will make new files sent from ChimeraX automatically display. There may be up to a 5-second delay displaying a new file.

Setup

To send the scene, the computer must know the Quest internet address. Start LookSee and enable "Receive files from ChimeraX" and it will show the address, for example, "Receive files from 192.168.0.157". Enter that address in the ChimeraX Send to Quest tool under Options. More detailed instructions are available.

Using a USB cable instead of WiFi

We don't recommend this method for sending scenes to the Quest unless a wifi connection is not available. To send a scene from ChimeraX using a USB cable connection, the computer must have the adb (Android Debug Bridge) command-line program installed (details here).

After setting up a USB connection it is possible to switch to sending wirelessly using adb. To set up wireless transfer, follow these steps:

  1. Plug in Quest to computer with usb cable.
  2. Click Allow Access in Quest headset.
  3. Select the "Use adb executable" option in under the Send to Quest Options.

It is also possible to use adb with a wireless connection with these additional steps.

  1. Check Quest IP address in headset clicking the wifi symbol in the Quest, then clicking the connected wifi name, then scroll down and click Advanced.
  2. Use adb command "adb tcpip 5555" from a shell on the computer.
  3. Use adb command "adb 192.168.0.135" to specify the Quest IP address.
  4. Disconnect usb cable from Quest.
  5. Optionally, check connected devices with "adb devices"

UCSF Resource for Biocomputing, Visualization, and Informatics / April 2023