EyeTrackVR DocsEyeTrackVR
Welcome to EyeTrackVR, a Source First, affordable eye-tracking platform designed specifically for adding to VR Headsets.
While built with Social VR (like VRChat) in mind, EyeTrackVR is highly versatile. It works by capturing real-time eye data and transmitting it via OSC, making it compatible with a wide variety of VR applications.
Whether you are here to build your own tracker, write code, or just see how it all works, you’ve come to the right place.
Getting Started
Ready to build? This documentation, covers everything from buying parts to flashing firmware. If you are new to the project, please follow these steps:
- Parts List – Read this first to understand what hardware you need.
- 3D Printed Parts – Read this to find what 3D prints you need.
- Prepare Cameras – Prepare the cameras.
- Prepare ESP32 – Prepare the ESP32s.
- Prepare IR LEDS – Prepare IR LEDS.
- Full Build Guide – Step-by-step instructions to assemble the setup.
This project is under active development. While it works reliably for many users, you may encounter bugs. Your feedback helps us improve!
Headset Compatibility
EyeTrackVR is designed to be universal. It can theoretically work with any VR headset, provided there is a way to mount the cameras inside.
Check our Mount List to see if a 3D-printable mount already exists for your specific headset.
Don't see your headset listed? You are welcome to design your own mount or join the community to see if someone else is working on one!
Community & Support
Need help? Want to show off your build? Join our Discord server! We’re excited to have you on board!
⚠️ Eye Safety in DIY LED Builds
Your safety is our top priority. Because this project involves Infrared (IR) light—which is invisible to the human eye—it is strictly important that you understand the risks. Our hardware is built with safety in mind, and so it is important that yours does too.
To ensure safety, you must adhere to the recommended LEDs, wiring diagrams, and firmware settings.
DANGER
Never bypass safety features or swap out IR components. Changing the recommended hardware without understanding the specific risks can result in permanent eye damage.
Our default configuration is designed to stay well below international safety thresholds (see ICNIRP guidelines). However, as a DIY builder, it is your responsibility to:
- Use Non-Focused Emitters: Never use focused laser-like components.
- Check Intensity: Keep total radiant intensity below 5 mW/sr.
- Verify: Use an IR-capable camera to visually check LED brightness.
- Listen to your body: If you feel warmth or discomfort in your eyes, stop using the device immediately.
Use only non-focused LEDs, and ensure total output is 4 mW/sr or less.