New Open-Source Tool Records Body Motion in VR Without Writing a Single Line of Code

Virtual reality has long promised psychologists a kind of laboratory that physical reality cannot offer: a world where every wall, avatar, and object can be placed with mathematical precision, and where a participant’s every movement can be logged as data. Yet a stubborn technical barrier has kept many research teams on the sidelines. To record how people move their heads, hands, and bodies inside a VR experiment, researchers typically had to build their own custom applications or modify existing software — work that demands programming expertise, game-engine skills, and months of development time. A team of Polish researchers now says that barrier can be dismantled. In a paper published in Behavior Research Methods, Pawel Kobylinski of the National Information Processing Institute in Warsaw and his colleagues introduce VRrec, a free, open-source tool that captures body-motion data from any PC-based VR application without requiring the researcher to write a single line of code.

The core insight behind VRrec is deceptively simple. Instead of embedding motion tracking inside a purpose-built experiment, the tool runs quietly in the background on a Windows PC, harvesting positional and rotational data from the headset, controllers, and optional body trackers while participants engage with whatever VR software the researcher has chosen — a commercial game, a mature third-party simulation, or an off-the-shelf training application. This design inverts the conventional all-in-one model, in which the same program both delivers the VR experience and records the data. With VRrec, the recording layer is decoupled entirely, meaning a study can be designed around existing VR content rather than around a bespoke application that must be coded, debugged, and rebuilt whenever the experiment changes.

Technically, VRrec is a Windows desktop application written in C# for the .NET 6 runtime. It taps into the OpenVR software development kit and relies on the SteamVR runtime to obtain tracking information from connected devices. The reference configuration validated in the paper consisted of an HTC Vive Pro headset, two Vive controllers, and six Vive trackers attached to a user’s body, but Valve’s documentation lists broader SteamVR-compatible families — including the Valve Index, Oculus Rift, and Windows Mixed Reality headsets, and, via the Steam Link streaming route, Meta Quest 2, 3, and Pro — as platform-side compatibility examples. The researchers caution that these broader configurations have not been individually validated and should be pilot-tested before research use.

The tool’s graphical interface is deliberately minimal. Researchers specify where the data file should be saved, name the file, and select a sampling frequency from six options ranging from 30 to 500 hertz. A configuration window displays the serial numbers of every tracked device the system recognizes, allowing users to assign human-readable aliases such as LeftHand to make later analysis easier. Pressing START begins recording; pressing STOP finalizes the file. Perhaps most importantly for experimental design, any keyboard key can be used to insert an event marker into the data stream — but only when Caps Lock is switched on, a safeguard that prevents accidental keystroke logging and is clearly indicated in the interface.

The output is a tab-separated text file in which every row corresponds to one recorded sample. Each row carries a sequential event number, a millisecond-precision timestamp, and, for every connected device, a rich set of fields: connection and pose-validity flags, three-dimensional position coordinates, linear and angular velocities, orientation expressed as a quaternion, and a full three-by-four transformation matrix for advanced applications such as inverse kinematics. Column names follow a self-explanatory scheme that encodes the device category, alias, serial number, parameter, and data type, so a column labeled Controller_LeftHand_LHR-493D7BY62_PosX_Float unambiguously identifies the left hand’s X-coordinate. Because the file is plain text, it can be imported directly into analysis pipelines built in Python, R, or MATLAB.

The authors are candid about the trade-off inherent in this background-recording approach. Because VRrec never reads the target application’s internal state, it cannot know what is happening inside the virtual world — no scene changes, no stimulus onsets, no distances to dynamic avatars. Paradigms that require millisecond-accurate synchronization with in-app events, such as reaction-time studies, fall outside its native capabilities. Manual keyboard markers partially compensate, and researchers can sometimes approximate spatial measures by calibrating static object locations beforehand or placing a tracker at a known reference point. The team also stresses that raw motion data are context-free: they become meaningful psychological indicators only when combined with a study’s theoretical framework and experimental conditions.

Why does body motion matter so much for behavioral science? The paper surveys a rich tradition. Classic VR studies showed that the amount a participant moves — particularly head rotation and bending — correlates with their sense of presence in a virtual environment, and that people maintain larger personal-space buffers around virtual humans than around similarly sized objects, with gender and culture shaping those distances. More recent work has pushed further: researchers have detected implicit prejudice in how closely participants approach avatars of different ethnicities, predicted racial bias from subtle head and hand movements during shooting decisions, and shown that fear can be read from motion-capture replays of people walking a plank at a simulated 80-story height — even from minimal point-light animations.

Clinical applications add further weight. A 2024 study fed VR movement patterns — headset and controller tracking, reaction times, and distractibility metrics collected during everyday tasks such as organizing a room or packing a backpack — into a machine-learning model that distinguished children with ADHD from those without with high accuracy. Other researchers have proposed combining VR simulations of daily activities with artificial intelligence to detect mild cognitive impairment in older adults through gait analysis. Against this backdrop, a tool that removes the coding barrier could substantially widen who can run such studies and how many paradigms become feasible.

The team put VRrec through punishing stress tests. In ten two-hour sessions totaling twenty hours of active use, a participant played the fast-paced rhythm game Beat Saber while VRrec recorded a headset, two controllers, and six body trackers simultaneously; the tool never crashed and never interrupted data collection. A separate 24-hour test with stationary devices likewise completed without failure, producing roughly 30 gigabytes of output. An R validation script, included in the project repository, confirmed that no rows failed parsing in any of the 34 test files. At the nominal 125-hertz setting, the median interval between samples was a stable 8 milliseconds, with the exact value spanning the 5th to 95th percentile in the long-term files. Rare timing outliers — occasional delays followed by catch-up bursts — were recorded transparently rather than hidden, and the authors note that many whole-body movement analyses do not require millisecond-level precision anyway.

The validation also surfaced a subtlety that reflects on the upstream hardware rather than the tool itself. In the stationary test, positional anomalies clustered tightly around moments when the tracking system’s pose-validity flag dropped — consistent with prior findings that consumer VR tracking can exhibit offsets after tracking loss and recovery. VRrec, by design, neither smooths nor corrects the incoming stream; it records exactly what the VR stack delivers, preserving device states, missingness, and timing so that problems can be diagnosed afterward. The researchers argue this transparency is a feature: even when a tracker’s battery died mid-session, the output file made the disconnection reconstructable. VRrec remains, by its authors’ own description, a recorder rather than an analyzer — it eliminates coding for data acquisition but not for interpretation. Still, with source code and executables freely available on GitHub, the tool invites community-driven improvement, and its authors hope it will make VR-based behavioral research accessible to teams that have until now watched from outside the headset.

Subject of Research: An open-source, zero-coding tool for capturing body-motion data in PC-based virtual reality for behavioral research

Article Title: VRrec: A zero-coding open-source VR body-motion capture tool for behavioral research

Article References: Kobylinski, P., Muczynski, B., Cnotkowski, D., Wierzbowski, M., & Biele, C. (2026). VRrec: A zero-coding open-source VR body-motion capture tool for behavioral research. Behavior Research Methods, 58(11), Article 308. https://doi.org/10.3758/s13428-026-03169-9

Image Credits: AI Generated

DOI: 10.3758/s13428-026-03169-9

Keywords: virtual reality, motion capture, open source, behavioral research, VRrec, SteamVR, body tracking, research methods, psychology, HTC Vive, data recording, human behavior