Windows operator app
Viscereality Companion
Viscereality Companion is the Windows operator surface for researchers, labs, and collaborators who want to use Viscereality without stitching together ADB, packaging, monitoring, and operator workflows by hand. It keeps install, launch, live telemetry, study-shell guidance, and session control in one place.
Purpose
Why this app exists
The broader Viscereality system includes a participant-facing Quest runtime, but researchers should not need to live inside that runtime project just to run a study. The companion app exists to translate Viscereality into a stable Windows operator surface: connect the headset, install the right build, check the live transport, and guide the session from one place.
That matters both for first-time collaborators and for labs that need a reproducible operator workflow. A good researcher-facing tool should reduce setup friction, narrow room for protocol mistakes, and make it obvious which parts of the session are healthy before a participant is already waiting.
Current capabilities
- USB and Wi-Fi ADB connection from Windows
- Install and launch for the bundled Sussex build or another supplied APK
- Live Quest, LSL, twin-state, and diagnostics monitoring
- Runtime profile, device-profile, and study-shell workflows
- Researcher-facing sequential guidance for the current Sussex protocol
Who it is for
- Research labs adopting Viscereality for a study or pilot
- Operators who need one clear GUI in place of several lab utilities
- Collaborators validating builds, telemetry, and participant handoff
- Teams that want a dedicated study shell, not a general debug surface
Current release
Sussex first, broader reuse next
The current public iteration is focused on getting the version for the collaboration with Hugo Critchley's lab at Sussex working cleanly end to end. That means the present release is not yet trying to be every possible multi-study operator surface. It is deliberately focused on a reliable install, launch, monitoring, and guided-session path for that collaboration first.
Once that path is stable, the same companion framework can be widened into a more general-purpose entry point for other Viscereality applications, other study shells, and other research or deployment contexts that need a clearer Windows-side control surface.
What the Sussex-first release includes
- `Sussex University experiment mode` as the dedicated operator surface
- Bundled approved Sussex APK, pinned device profile, and operator diagnostics
- Sequential Guide and Experiment Session windows for researcher workflow
- Packaged Windows install path for reproducible lab handoff
What comes after that
- Broader multi-study launcher and reusable shell templates
- More generalized operator UX for non-Sussex protocols
- Cleaner reusable packaging for other collaborators and deployments
Adaptation work
Custom builds and lab-specific variants
I am open for hire if a team needs specific adaptations to either the broader Viscereality app itself or the Windows companion. In practice that can mean narrowing the UI to a specific protocol, adding or simplifying telemetry, packaging a dedicated study surface, or aligning the operator workflow with the reality of a lab's setup rather than the assumptions of a generic tool.
The useful work here is usually translational: making a research system legible, reproducible, and operable by the people who actually need to use it.
Typical adaptation areas
- Custom study shells and locked-down operator flows
- Telemetry, export, and session-review adaptations
- Protocol-specific startup profiles and packaged releases
- Lab deployment hardening and researcher onboarding
Public surfaces
- Docs and downloads for install, walkthroughs, and operator documentation
- viscereality.org for the broader project framing
- Public source repo for the Windows companion code
- Mesmer Prism contact for adaptation work and collaboration