Skip to content
This repository has been archived by the owner on Dec 30, 2022. It is now read-only.

Sgeo/Guardian2Chaperone

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Note that with recent SteamVR changes, this program is mostly obsolete. SteamVR seems to read the Oculus configuration as soon as it starts.

Guardian2Chaperone

Purpose

This utility transfers the Oculus Room Setup data to SteamVR for Oculus Rift. It moves the SteamVR floor to match the Oculus floor, the SteamVR play area to Oculus play area, and makes the Chaperone bounds match the Oculus bounds [and makes the SteamVR bounds invisible]

Usage

Set up Oculus Room Setup, then run this utility, which can be downloaded from the releases section. You can run this utility instead of running SteamVR Room Setup

Notes

  • Your Rift and cameras should probably be connected before running this.

  • This code makes a lot of assumptions that I believe are valid, but I am not 100% certain if they are valid for all configurations, and if they will be valid in the future.

  • This utility has been observed to cause SteamVR to freeze if run while SteamVR is running. Just close SteamVR via the Universal Menu and start it again.

  • This turns the SteamVR bounds invisible. Keep Oculus Guardian on, or make the SteamVR bounds visible in the SteamVR customization menu. The SteamVR bounds will match Oculus bounds, but might look ugly.

  • The Oculus play space may be smaller than SteamVR's usual minimum play space. The utility will set the SteamVR play space to match Oculus, but the utility will give no notice that this has occurred, and I cannot predict how SteamVR applications will react.

  • This is for Rift users of SteamVR. If you use both Rift and Vive, I believe only Rift's SteamVR setup will be altered. The Vive's settings may be maintained separately.

  • If you recenter while in Oculus Home, the position of the play space shifts. This is a SteamVR limitation, and rerunning this tool will put the play space in the proper location. Not being aware of this can be actively dangerous if you disable Oculus Guardian and rely only on SteamVR Chaperone.

  • I have no idea what happens if a Vive user using Revive runs this. It might be entertaining, but I doubt of any practical use.

Credits

  • Oculus's GuardianSystemDemo used as a starting point, but almost none of that code remains.

  • OpenVR-Advanced for helping me understand the OpenVR API functions required.