EyeTrackVR DocsEyeTrackVR
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:
- Things to Know – Important background before diving in
- Full Build Guide – Step-by-step assembly instructions
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
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!
