Skip to content

Releases: challenger0303/SRanibro

SRanibro v0.1.7-beta - PSVR2

Pre-release

Choose a tag to compare

@challenger0303 challenger0303 released this 06 Aug 14:11
421942a

SRanibro v0.1.7-beta - PSVR2

This is the PSVR2-only beta build of SRanibro. It uses the PSVR2Toolkit path and keeps separate settings from the normal multi-headset build.

Highlights

  • Native PSVR2 gaze, pupil, blink, and paired eye-camera input through PSVR2Toolkit.
  • Visual per-eye openness thresholds with live response, EyeWide range, and Squeeze range tuning.
  • Optional mirrored-right inference for more consistent left/right eyelid behaviour.
  • GPU eyelid inference with validated CPU fallback.
  • Eyebrow source selection from the main screen: EyeWide-linked or independent estimation.
  • Bundled generic eyebrow.bin; personal fitted eyebrow models still take priority.
  • Optional eye-camera preview to reduce foreground rendering cost when hidden.
  • Updated VRCFaceTracking module v0.2.3.
  • No Tobii DLL is required by this PSVR2 build.

Requirements

  • Windows, SteamVR, the official PlayStation VR2 PC software, and a current PSVR2Toolkit installation.
  • PSVR2Toolkit eye-camera access. Native gaze alone is not enough for continuous eyelid estimation.
  • SRanipal EyePrediction weights selected in SRanibro Settings; model weights are not included.

Close the separate PSVR2 hardware probe and any other PSVR2Toolkit gaze client before starting SRanibro, then start SteamVR and complete the normal PSVR2 eye calibration.

Downloads

  • SRanibro-v0.1.7-beta-PSVR2-bundle.zip — recommended; application, eyebrow model, VRCFaceTracking module, and setup guide.
  • SRanibro-PSVR2-Beta.exe — PSVR2-only application.
  • eyebrow.bin — bundled generic eyebrow model.
  • SRanibro-VRCFT-module.zip — VRCFaceTracking module v0.2.3.

SHA-256

60EA6D8236EE21D745CA87A7223006714EC069C0B957DCC0735FE65EB7E07887  SRanibro-PSVR2-Beta.exe
10DA6CAAED21F3480F5B51BA6518E2C3F403D0C11DC0650B3C6878F7776F042C  eyebrow.bin
FAEA99FD1FEC99D32C1896B4932AFB6AF5AFCB03EAD6E0D115C46D94CBF9B740  SRanibro-VRCFT-module.zip
88E2D8D70711D26333292AED0F1EB37E37DD8F6D584F3AF24E011DFF29018A72  SRanibro-v0.1.7-beta-PSVR2-bundle.zip

This is an unsigned beta executable, so Windows SmartScreen may warn. Download it only from the official SRanibro GitHub release.

SRanibro v0.1.7-beta

SRanibro v0.1.7-beta Pre-release
Pre-release

Choose a tag to compare

@challenger0303 challenger0303 released this 06 Aug 14:11
421942a

SRanibro v0.1.7-beta

This beta focuses on practical eyelid tuning, stable inference, and a cleaner setup flow for supported hotmirror VR headsets.

Hotfix — 2026-08-07

  • Improved EyeWide response for users whose previous output was weak or inactive.
  • EyeWide now evaluates both physical eyes through SRanipal's more responsive right-eye model head: the left image is mirrored into that head, while the right image keeps its natural orientation.
  • Eyelid openness and blink handling remain on the validated left-head route; the new EyeWide path has its own baseline and is suppressed during blinks or invalid eyelid tracking.
  • The live response rail now separates normal openness and EyeWide clearly: green stops at the Wide boundary, and orange alone represents EyeWide.
  • This hotfix replaces both SRanibro.exe and the recommended bundle. The VRCFaceTracking module and eyebrow.bin are unchanged.

Highlights

  • Visual per-eye openness thresholds with live response, EyeWide range, and Squeeze range tuning.
  • Optional mirrored-right inference for more consistent left/right eyelid behaviour.
  • GPU eyelid inference with validated CPU fallback.
  • Eyebrow source selection from the main screen: SRanipal-style EyeWide link or independent estimation.
  • Bundled generic eyebrow.bin; personal fitted eyebrow models still take priority.
  • Simplified device, filter, preview, and eyelid controls.
  • Eye-camera preview can be hidden to reduce foreground rendering cost.
  • Recenter and baseline recovery improvements.
  • StarVR One connection recovery: SRanibro can try the available connection routes, verify that stereo images and wearable data are actually live, and remember the route that succeeds.
  • The official build includes the separately validated StarVR runtime; no manual StarVR DLL path is required.
  • Updated VRCFaceTracking module v0.2.3.

Downloads

  • SRanibro-v0.1.7-beta-bundle.zip — recommended; application, eyebrow model, VRCFaceTracking module, and setup guide.
  • SRanibro.exe — application only.
  • eyebrow.bin — bundled generic eyebrow model.
  • SRanibro-VRCFT-module.zip — VRCFaceTracking module v0.2.3.

SRanipal EyePrediction weights are still required for eyelid inference. Keep eyebrow.bin beside the executable for automatic discovery.

SHA-256

50C7DCFF2264BFBB9FC736B2A3BB5787010C65580F9A48AAA6AD87F2E03D08EC  SRanibro.exe
10DA6CAAED21F3480F5B51BA6518E2C3F403D0C11DC0650B3C6878F7776F042C  eyebrow.bin
FAEA99FD1FEC99D32C1896B4932AFB6AF5AFCB03EAD6E0D115C46D94CBF9B740  SRanibro-VRCFT-module.zip
09AAF5968080EB19D440597705D7491A1AA5A88DB61648EF158ED61C08933BA0  SRanibro-v0.1.7-beta-bundle.zip

This is an unsigned beta executable, so Windows SmartScreen may warn. Download it only from the official SRanibro GitHub release.

SRanibro v0.1.5-beta

SRanibro v0.1.5-beta Pre-release
Pre-release

Choose a tag to compare

@challenger0303 challenger0303 released this 18 Jul 07:21

SRanibro v0.1.5-beta

This beta adds Pimax Dream Air / XR5 support while retaining the existing Pimax VR4, StarVR One, and Varjo paths.

Compatibility hotfix

  • XR5 image EyeWide, combined-gaze correction, and related runtime state are now applied only while Dream Air / XR5 is active. VR4, StarVR, Varjo, and VPE always retain their established SRanipal-derived EyeWide path.
  • Eyelid calibration is now stored separately for each HMD, preventing an XR5 baseline, blink depth, or mid-close anchor from leaking into another headset.
  • XR5-only controls are hidden outside XR5, and an active Wide capture is cancelled safely when Apply & reload switches devices.
  • The former shared sranibro_calib.toml is left untouched because its originating HMD cannot be identified safely. After updating, use Recenter once on each HMD to establish its new per-device calibration file.

Highlights

  • Dream Air / XR5 200x200 120 Hz stereo eye-camera, Tobii wearable data, and native EyeChip gaze support.
  • Optional fused EyeChip gaze plus saved per-eye center, range, and vergence correction.
  • Safe Geometry Fit with OPEN/HALF/CLOSED, gaze, slow-close, blink, and untouched holdout phases. The fixed inner XR5 IR LED/lens area is excluded from the search.
  • Opt-in calibration recording export containing labelled stereo PNGs and anonymized metadata for feedback.
  • Personal XR5 image EyeWide and eyebrow collection/fitting workflows.
  • Stable eyebrow post-processing, master enable switch, and direct VRChat FT/v2 eyebrow OSC.
  • Long-session eyelid calibration, shallow-eye reach, blink handling, gaze-yoke, Wide symmetry, and Wide-to-blink transition improvements.
  • UI cleanup, collapsible calibration sections, adaptive brightness, and minimized-window memory fixes.

Model and runtime requirements

  • SRanipal eyelid weights and a Tobii stream-engine DLL are not bundled. Supply copies you are authorized to use.
  • Safe Geometry Fit is implemented entirely in the executable and needs no Python, but evaluates the configured SRanipal eyelid model.
  • Eyebrow and XR5 EyeWide Fit in app (no Python) refit a head on an existing compatible base model. Base brow.bin / Wide model weights are not bundled.
  • Creating an eyebrow base model from scratch with Train & Bake still requires Python, PyTorch, and the separate vr_eyebrow training project.

Included downloads

  • SRanibro.exe — application.
  • SRanibro-VRCFT-module.zip — stable eye-only VRCFaceTracking module v0.2.2.
  • SRanibro-v0.1.5-beta-bundle.zip — both files above.

SHA-256

8CE06DDB80AE96FA6E904433347AAD6D2DA615CD3905599DDD9B87A5288403F0  SRanibro.exe
9FBFCAE291AE2D957618C001DE27DD84027174B90F5EFB0D220EB250BDBACF8B  SRanibro-VRCFT-module.zip
348D3875D9EEBF08C291516DE950A4BE2C80E2967D50B47B7EAFBEFE3B665BB2  SRanibro-v0.1.5-beta-bundle.zip

This is an unsigned beta executable, so Windows SmartScreen may warn. Download it only from the official SRanibro GitHub release.

SRanibro v0.1.4-beta

SRanibro v0.1.4-beta Pre-release
Pre-release

Choose a tag to compare

@challenger0303 challenger0303 released this 12 Jul 09:24

SRanibro v0.1.4-beta

What's new

  • Added native StarVR device support to the Tobii runtime selector.
  • Reworked eyelid closing around Tobii's native absolute openness state: slow closes follow the ML motion, while fast blinks snap both lids shut. Fast winks remain per-eye.
  • Removed Simple mode and its old reach controls in favor of the new native-state behavior.
  • Added live VRCFT openness low-pass control in SRanibro settings.
  • Improved dashboard/window responsiveness and reduced unnecessary eye-camera texture uploads.
  • Fixed the blank Data Collection Abort button in the dark theme.

VRCFaceTracking module

  • Restored the stable eye-only SRanibro VRCFT Module behavior as v0.2.2.
  • Maps gaze, openness, pupil diameter, EyeWide, and EyeSquint.
  • Does not claim the Expression/Face provider slot.
  • Removed eyebrow mapping from the VRCFT module for this release.
  • The module is included as a separate ZIP and in the bundle.

Downloads

  • SRanibro.exe — standalone application
  • SRanibro-VRCFT-module.zip — custom VRCFaceTracking eye module
  • SRanibro-v0.1.4-beta-bundle.zip — both files together

SHA-256

  • SRanibro.exe: 1561dc75086bad68f20d264b270b7a84a8cea4d42fa8973a12c3c39d18f11b09
  • SRanibro-VRCFT-module.zip: 9fbfcae291ae2d957618c001de27dd84027174b90f5efb0d220eb250bdbacf8b
  • SRanibro-v0.1.4-beta-bundle.zip: 602e733fc20dd372c9f0c63f2c76b96ebb7268600a068aa0b01dd1c67dde004b

This is a beta build and is not code-signed, so Windows SmartScreen may warn. Tobii/SRanipal runtimes, model weights, and other proprietary assets are not included.

SRanibro v0.1.3-beta

SRanibro v0.1.3-beta Pre-release
Pre-release

Choose a tag to compare

@challenger0303 challenger0303 released this 07 Jul 15:06

SRanibro v0.1.3-beta

What's new

  • Calibration overhaul: expressions (long squints, held wide eyes) can no longer
    corrupt the auto-calibration, drift self-recovers within seconds, and Recenter
    now reliably fixes everything instantly. Also fixes setups whose camera levels
    sit lower than usual (one eye could stop calibrating entirely).
  • Slow-blink calibration now STICKS: 2-3 deliberate slow blinks teach each eye's
    true closed point and equalize the left / right response on slow closes.
    Remembered across restarts.
  • Fast-blink detection rebuilt: per-eye sensitivity (a weaker eye camera no
    longer misses quick blinks), no more one-eye-half-open blinks, and no more
    "bounce" right after the lids close -- held winks stay fully shut.
  • Per-eye image settings (both / left / right) in the gear, with sliders that
    sync to the selected eye.
  • NET view toggle on the eye cameras: see the exact image the model sees.
  • NEW in the refreshed build: a "blink recovery (ms)" slider (Tuning) -- sets a
    minimum reopen time after a blink so avatar animations don't miss it; and a
    gaze-yoke fix (gaze no longer trembles with the yoke enabled).
  • Diagnostic recorder (REC, Calibration tab): captures a CSV of raw + processed
    tracking values -- attach it when reporting tracking issues.

Download
SRanibro.exe (9,758,208 bytes)
SHA-256: 53c68066873b466dcf6ee2f185082ebffd8c931bf64c069a37b662f98735e535

Beta -- expect rough edges; not code-signed (SmartScreen may warn). See README for setup.

SRanibro v0.1.2-beta

SRanibro v0.1.2-beta Pre-release
Pre-release

Choose a tag to compare

@challenger0303 challenger0303 released this 04 Jul 18:09

SRanibro v0.1.2-beta

What's new

  • Steadier openness: fixed an eye reading stuck part-open at rest.
  • Reflection filter (on by default): removes bright IR / glasses reflection dots
    that destabilized the openness reading. Glasses wearers -- this is the big one.
  • A squinting / winking eye now follows your open eye instead of freezing.
  • New ML-input tools on a gear (top-left of the eye cameras): crop / rotate /
    stretch, an experimental Brightness match (opt-in), and a response heatmap.
  • Optional wide / squeeze link.
  • Assorted reliability fixes.

Download
SRanibro.exe (9,702,912 bytes)
SHA-256: c01d8167c3c6fc78b3e4f1f4515073de017420ddd526a69f2bc27241c4e69eaf

Beta -- expect rough edges; not code-signed (SmartScreen may warn). See README for setup.

SRanibro v0.1.1-beta

SRanibro v0.1.1-beta Pre-release
Pre-release

Choose a tag to compare

@challenger0303 challenger0303 released this 03 Jul 13:51

SRanibro v0.1.1-beta

What's new

  • New Console tab: a live view of SRanibro's log output (device handoff, connection, ML).
  • Device selection now defaults to "auto" (auto-detects a connected Pimax eye-chip).
    StarVR One users: select "starvr".
  • Smoother dashboard: fixed window-drag stutter; more responsive repaint.
  • Assorted reliability and device-handling improvements.

Download
SRanibro.exe (9,558,528 bytes)
SHA-256: a6187c36a3b9011626dfeac4e1d19c4ca0159cabfdacf616c7715371e61a31b5

Beta — expect rough edges; not code-signed (SmartScreen may warn). See README for setup.

SRanibro v0.1.0-beta

SRanibro v0.1.0-beta Pre-release
Pre-release

Choose a tag to compare

@challenger0303 challenger0303 released this 29 Jun 15:18

First public beta.

VR eye-tracking -> VRCFaceTracking bridge for Tobii-based eye-tracking VR headsets (Pimax Crystal / Crystal Super, StarVR One). See the README for setup.

SRanibro bundles nothing proprietary -- supply your own SRanipal install + Tobii stream-engine DLL.

Download: SRanibro.exe (asset below)
SHA-256: 3de3a5e2d3bb61ac9ed01fd017b275783dd3bd656da829ce7c1606821fa301c6

Notes

  • Beta; expect rough edges. Eyebrow tracking is not in this build.
  • The exe is not code-signed yet, so Windows SmartScreen may warn. Verify the SHA-256 above before running.