ThumbParamsOSC

OSC program that makes SteamVR controller actions, Tracker button actions and XInput actions accessible as Avatar Parameters.

Currently supports Valve-Index, Oculus(Meta)-Touch, SteamVR Trackers and XInput Controllers.

Discord Support Server

🢃 Download Latest release

Available Parameters

Following sections go over all available parameters. All parameters are case-sensitive.

SteamVR Controller Parameters

Tracker Parameters

XInput Parameters

Special Parameters

The two int parameters RightThumb and LeftThumb represent the position of each thumb with the numbers from 0 to 4:

The int ControllerType gives what controller is currently being used:

[Left/Right]ABButtons detects if the thumb is on either the A or B buttons, or Touching both at the same time.

Tracker Power button parameters require Tracker roles to be set up in SteamVR:
Go to SteamVR-Settings > Manage Trackers and set up tracking roles for each tracker respectively:

How to use

Activate OSC in VRChat:

In Action menu, got to Options>OSC>Enable

Run Configurator.exe to configure the program.

Then just run the ThumbParamsOSC.exe and you are all set!

OSC Troubleshoot

If you have problems with this program, try this to fix it:

• Automatic way:
  • Close VRChat.
  • Run Configurator.exe and click on the Button "Reset OSC Config"
  • Startup VRChat again and it should work.
• Manual way:
  • Close VRChat.
  • Open 'Run' in Windows (Windows Key + R)
  • Type in %APPDATA%\..\LocalLow\VRChat\VRChat\OSC
  • Delete the folders that start with 'usr_*'.
  • Startup VRChat again and it should work.

Decreasing OSC Traffic

ThumbparamsOSC consistently sends the current state of each parameter, with a lot of parameters the OSC traffic can increase significantly.
To mitigate this there are a three things you can do:

• Disable all parameters that you do not need.
• Switch to a different mode then "Always Send"
• Lower the Polling Rate You can read on how to do that in #Configuration

Configuration

Running Configurator.exe lets you customize the Parameters that you want to have sent to VRChat, and some more things:

Unchecking or checking any of the parameters and the hitting save will save the current settings.
You can use the buttons below to do quick unticking or ticking of groups of parameters

• Floating Time allows values "float" on the last value registered, it is measured in seconds.
  
  • If Floating Time is set to -1 for boolean values, they will act like a toggle instead of always updating to the current state.
• Tick the Unsigned Box for any supported parameter to map the float value to [0, 1] instead of [-1, 1]
• Mode has 3 different values:
  • "Send On Change" (Default) As the name might suggest, it sends a parameter only when it has changed from its previous value.
  • "Send On Positive" It sends a Parameter when it changes, but also continuosly sends Positive values every Poll.
  • "Always Send" This is like the old behaviour, just sends the parameters current state every Poll.
  • You can use the three buttons below to quickly switch between modes for every parameter

Automatic launch with SteamVR

On first launch of the program, it registers as an Overlay app on SteamVR just like other well known programs like XSOverlay or OVRAdvancedSettings and can be launched on startup:

After setting the option to ON it will launch the program without the console on SteamVR startup.

Command line Arguments

You can run this by using ThumbParamsOSC.exe {Arguments} in command line.

Credit

• pyopenvr thank you.
• benaclejames and Greendayle for the inspiration!

Great Projects making use of ThumbparamsOSC:

• VRC-ASL_Gestures by me :)
• VRCImmersiveImmobilize by me :)
• AutoImmobilizeOSC by SouljaVR
• Drone-OSC-Controller by Qbitz