PSMoveServiceEx-PSVR

Modified for PSMoveServiceEx-PSVR in 2026. See NOTICE and MODIFICATIONS.md.

PSMoveServiceEx-PSVR adds webcam tracking of the seven built-in blue LEDs on a PSVR1 headset. It combines the webcam pose with the headset's own timestamped IMU data to provide seated 6DoF through the existing PSMoveService protocol. iVRy can continue to own the display and SteamVR HMD while consuming the pose from this service.

The first release is deliberately a hardware-test preview. The Windows build, package smoke checks, and deterministic tracking tests are automated, but a real PSVR, webcam, iVRy, and SteamVR session is still required before the tracking path can be called hardware-validated.

Start here

1. Download the newest Win64 preview and its .sha256 file from Releases.
2. Verify and fully extract the package using Windows preview builds.
3. Follow PSVR webcam 6DoF: SteamVR first run from beginning to end.
4. If something fails, collect the evidence listed at the end of that guide and open an issue.

Do not mix the preview executables, DLLs, or assets folder with another PSMoveServiceEx build. Back up %APPDATA%\PSMoveService before the first run.

What this version adds

• stable Windows webcam discovery and capture through Media Foundation;
• a calibrated seven-point PSVR LED constellation and robust PnP solver;
• PSVR sensor-clock mapping to the host clock;
• delayed optical-pose correction fused with low-latency IMU orientation;
• Config Tool controls for webcam selection, LED regions, intensity, and tracking diagnostics;
• deterministic tests for clock rollover, pose solving, fusion, capture timestamps, mode selection, and stable camera identity;
• a reproducible, checksummed Win64 preview package.

The detailed design, limitations, and validation criteria are in PSVR built-in LED tracking.

Compatibility

• CUH-ZVR1 and CUH-ZVR2 PSVR1 headsets;
• 64-bit Windows 10 or 11;
• one fixed webcam with a native, BGR-convertible 640 x 480 mode;
• iVRy base driver, its PSVR Lite or Premium DLC, and the free PSMoveServiceEx tracker bridge;
• PSMoveService protocol 0.9-alpha9.0.0, retained for iVRy compatibility.

The preview binary intentionally excludes the bundled PS3EYEDriver backend because that component contains GPLv2-derived code. A standard Windows Media Foundation webcam is required for this preview; the bundled native PS3 Eye camera path is unavailable. The generic-webcam tracker used by this project remains enabled. Developers may opt into the legacy PS3EYEDriver source when building, but any resulting distribution must comply with its applicable GPL terms.

Building

The supported Windows workflow and equivalent local commands are documented in Windows preview builds. The package uses a replaceable libusb DLL and includes third-party license notices.

Project lineage

This is a normal, independently maintained repository—not a pull request to the upstream project. It preserves the complete history and attribution chain:

psmoveservice/PSMoveService → Timocop/PSMoveServiceEx → Davidbkr03/PSMoveServiceEx-PSVR

The independent work starts from Timocop's commit f49e85eeda00a63c3c2d4fc41b321f896541e170. Timocop's wiki and the original PSMoveService wiki are useful legacy references, but they do not document or support this webcam LED tracker.

Attribution

Thanks to Timocop for PSMoveServiceEx; HipsterSloth and all contributors to the original PSMoveService; Thomas Perl and psmoveapi; Alexander Nitsch and psmove-pair-win; the PS3EYEDriver contributors; Frédéric Lopez and PS-Move-Setup; Greg New; YossiMH; William (zelmon64); Antonio Jose Ramos Marquez; and every contributor retained in the Git history.

See NOTICE, MODIFICATIONS.md, THIRD_PARTY_NOTICES.md, and LICENSE. Third-party components retain their own licenses. PSMoveServiceEx-PSVR is not affiliated with or endorsed by Timocop, Sony Interactive Entertainment, Valve Corporation, or the developers of iVRy.