VR Utils

A few tools I've made over my time playing VRChat.

ALVRConnectionOSC - OSC headset connection status updates for ALVR

A small program to send an OSC message with a BOOL value when a headset connects to or disconnects from ALVR, so things can match state. Useful for example if you have an unstable connection or need to leave intermittently.

By default it is set up to set a VRChat avatar parameter hardware/headsetConnected (Bool), which your avatar can be set up read to enter an "away" or "error" state to let other people know you can't hear or see them anymore. As an example, my personal avatar plays a sound and flashes the outline red, then changes to a Resonite-style away material when I disconnect.

In addition, it (by default) sends a chatbox message [Headset Disconnected] and clears it when the connection is restored so you don't need specific avatar setup. (though it can be funny for others if your avatar does something in the meantime)

Setup:

• Make sure you have Python3 and PythonOSC installed. (pip install python-osc)
• Place the script files somewhere ALVR can get to.
• Open ALVR's config screen. (or session.json, that works too)
• Change the "On Connect Script" and "On Disconnect Script" options to contain:
  • Windows: the absolute path to the script.bat file. (e.g. C:\Users\user\...\alvr_streamer_windows\script\script.bat)
  • Linux: the absolute path to this file. Untested. (e.g. /home/user/alvr/scripts/connection.py)

You can edit the script to change basic functionality, there are some variables near the top of connection.py with descriptive comments so they should be easy to find.

Known Issues:

• At the moment on Windows it pops up a Command window whenever it runs. I do not know how to prevent this.
• May not work on Linux, can't test it since my setup doesn't even use SteamVR, let alone ALVR.

HMD Battery Test - Test integration of battery level indicators

A set of tests to check avatar setup for battery-displaying functionality on VRChat avatars, for example, using my Battery Prefab.

Contains tests:

• Set battery to Full (1)
• Set battery to Empty (may not work. unsure exactly why, but it doesn't like sending -1)
• Charge test (0 to 1, set charging)
• Discharge test (1 to 0)
• Clear battery - set to a negative value so the avatar can know there is no battery
• Overlay integration: connected with battery full (sets open overlays to 2)
• Overlay integration: connected only - no battery sent (sets open overlays to 2)
• Disconnect WlxOverlay-S integration (resets the expected default open overlays value to 255)

Some prefabs or avatars may support connected without battery status - this is what the connected with no battery test is for. Battery Prefab and Badge support this.

This is because the provider doesn't strictly need to send the battery parameter constantly, for example WlxOverlay-S only sends the battery every 10 seconds, while the open overlays are sent every 0.1 seconds.

Indicators may display a "connecting" animation when they receive a different, frequently-updated parameter until they receive a battery level to at least show the connection is working.

My batteries use the following parameters internally:

• battery/level - The level shown on the batteries.
• battery/charging - Whether to show the charging indicator.
• battery/visible - If the battery indicator should be shown or not.
• battery/connected - If the provider is connected but may not be sending battery yet. This is not required to be set before showing the battery level. They also have a layer that takes in parameters from external OSC-sending software and converts them to the internal format. This simplifies the logic.

ProTV3 Playlist From Files

Walks a directory, reading in filenames and extracting YouTube IDs from them. Expected format: video title [youtube id] (this is the format output by yt-dlp, extensions are ignored) These are formatted into the ProTV3 playlist format, with the video title sanitised and a link generated from the ID, and written to a file named protv_playlist.txt.

If you don't want to store/download the actual video files, making dummy files works too, just name them video title [youtube id] as above.

OSC Sender

A small script to send singular OSC values to specific addresses. That's it. By default prepends "/avatar/parameters/" to all messages - this can be changed.

References:

• PythonOSC

Shameless Self-Promotion:

• Battery Prefab (Full battery support)
• Badge Avatar (Partial battery support)