Standardizing XR Behavioral Research

The Open Toolkit for XR Research.

An open-source, end-to-end toolkit for Meta Quest headsets. Record high-frequency multimodal data, automate quality validation, and export to BIDS format.

Explore Documentation View on GitHub

Why ResXR?

⚡

Addressing Technical Barriers

Creating immersive experiments demands specialized programming skills. ResXR provides an accessible Unity template designed for scientific applications, ensuring precision without building from scratch.

📊

Data Standardization

The lack of standard formats limits reproducibility. ResXR automates the conversion of complex tracking data into Motion-BIDS compliant datasets, ready for immediate analysis and sharing.

Toolkit Architecture

A powerful combination of a Unity recording template and a Python processing pipeline.

Stage 1: Unity Base Template

Standalone Data Capture

A Unity 6 template for behavioral experiments running on Meta Quest 2/3/Pro.

100 Hz Recording: Head, hands, eyes, face, and body tracking in Unity's FixedUpdate.
Core Components: ResXRPlayer and ResXRDataManager for synchronized collection.
Built-in Paradigms: Demo experiments for Binary Choice, Maze Navigation, and Museum Viewing.

Unity Template Repo

Stage 2: Python Data Pipeline

Processing & Validation

Converts raw tracking data into Motion-BIDS compliant datasets with visual quality reports.

BIDS Compliance: Generates motion.tsv, events.tsv, and LATENCY channels.
Quality Validation: Detects tracking loss, sampling irregularities, and tracks eye closures.
Interactive Reports: HTML visualizations of flag times mapped to global timeSinceStartup.

Python Pipeline Repo

Integration

Seamless Workflow

Standardized Output

Your raw recordings are converted into a strictly compliant Motion-BIDS dataset — one tracking system per file, with sourcedata and derivatives preserved alongside an interactive HTML quality report.

output/
- dataset_description.json
- participants.tsv
- sub-01/
  - ses-01/
    - 2026.06.10_18-22_report.html
    - sub-01_ses-01_scans.tsv
    - sub-01_ses-01_task-VRtracking_events.tsv
    - motion/
      - sub-01_ses-01_task-VRtracking_tracksys-Head_motion.tsv
      - sub-01_ses-01_task-VRtracking_tracksys-Eyes_motion.tsv
      - sub-01_ses-01_task-VRtracking_tracksys-Hands_motion.tsv
      - sub-01_ses-01_task-VRtracking_tracksys-Face_motion.tsv
- sourcedata/
- derivatives/resxr/

Visuals

Ready-to-use Paradigms

Museum Paradigm

Free-roaming environmental navigation.

Maze Navigation

Spatial memory and pathfinding tasks.

Binary Choice

Controlled forced-choice psychological tasks.

Live Monitor

Real-time telemetry and subject tracking.

Preprint

Read the Preprint

In preparation for publication

The ResXR toolkit is described in detail in our preprint, which is currently in preparation for publication. Cite or reference our work using the DOI below.

DOI 10.64898/2026.06.17.732869

View Preprint

Supported by

The Neuro — Montreal Neurological Institute-Hospital, Tanenbaum Open Science Institute