Skip to content

oculus_reader

  • Software
  • Humanoids and robot learning
  • Tool

A Python tool that reads the pose and button presses of Oculus Quest controllers, using an Android app installed on the headset and communicated with over ADB.

Made by Robotic AI & Learning Lab Berkeley.

Source on GitHub: github.com/rail-berkeley/oculus_reader (opens in a new tab). Facts read at commit 2cf70ab (opens in a new tab).

Licenses

Code
Apache-2.0 (opens in a new tab)

Read by Robotheca from LICENSE (opens in a new tab) (Apache-2.0) at commit 2cf70ab (opens in a new tab), on 16 Oct 2026.

Commercial use
Yes

What it does

  • Streams controller position and pressed buttons from the Oculus Quest headset to a Python script.
  • Relies on an APK running on the headset; its source code is provided so the behavior can be extended.
  • Can connect over a USB cable, or over the network once the headset's IP address is known.
  • Optionally visualizes the controller transforms with a ROS script if ROS is installed.

Written by Robotheca from the project's README (opens in a new tab) at commit 2cf70ab.

Getting started

Difficulty
Intermediate
Hardware it needs, as the project states it
An Oculus Quest headset connected to the computer by USB cable, with ADB installed; the headset needs Developer Mode enabled and, for network use, the same network as the computer.

Maintenance

Status
Maintained: a commit in the last 12 months
Newest commit
14 May 2026 on main
Latest release
None published on GitHub

Checked on GitHub on 16 Oct 2026.

Robots that can run it

No robot on Robotheca is linked to it yet. Links come from a robot's robot.yaml, from its dependency files read as text, or from Robotheca's editors.

Robotheca lists software as a reference: nothing is hosted or run here, and every fact links to where it was read.