Skip to content

EyeTrackVR

EyeTrackVR is a Source First, affordable eye-tracking platform designed specifically for Virtual Reality—especially for Social VR experiences like VRChat. It works by sending real-time eye tracking data over OSC or UDP, making it compatible with many existing VR applications.

Whether you're here to build your own tracker, contribute to development, or explore how it works, you're in the right place.


Get Started

This documentation covers everything from assembly and firmware setup to headset mounting and safety. If you're new to the project, we recommend starting with the following pages:

CAUTION

This project is under active development, but it's already working reliably for many users. Your feedback helps us improve!


Eye Safety Notice

Eye safety is a top priority. Infrared (IR) light is invisible but not harmless—especially at close distances and high intensities. EyeTrackVR has built-in safety measures, but users must also follow proper precautions.

Always use the recommended LEDs, wiring, and firmware settings.

DANGER

Never bypass safety features or swap out IR components without understanding the risks. Doing so could result in permanent eye damage.

Our default configuration stays well below international safety thresholds (see ICNIRP guidelines), but it's your responsibility to:

  • Use non-focused emitters
  • Keep total radiant intensity below 5 mW/sr
  • Verify LED brightness with an IR camera
  • Stop using the device if you feel warmth or discomfort in your eyes
WARNING
Please pay attention

Use only non-focused LEDs, and ensure total output is 4 mW/sr or less.

Safety References

Effect of infrared radiation on the lens
Photobiological safety of LED light sources
ICNIRP Guidelines (0.38 to 3 µm)
Training Library – NIR Standards


Hardware Overview

See our Parts List and Hardware Repository to source components, print mounts, and prepare your setup.

Firmware

The firmware powering EyeTrackVR's ESP32 cameras is called OpenIris, developed by lorow.
You can find it here on GitHub.


Headset Compatibility

EyeTrackVR can work with any VR headset—but not every model has a 3D-printed mount available yet.

Check our mount list to see if your headset is supported.
If not, you’re welcome to design your own or wait for a community-sourced version.


Community & Support

Join our Discord server for updates, and community projects. We’re excited to have you on board!

'discord banner'

Released under the MIT License.