OSC Avatar Manager
This is a personal project that includes a face tracking relay from ALVR to OSC (VRCFT replacement), among other things.
Pros vs VRCFT:
- Runs on Linux
- Does not randomly crash
Cons vs VRCFT:
- Fine tuning of face tracking parameters can only be done in code
Supported:
- Quest Pro (eye + face)
- Pico 4 Pro (eye only)
- Project Babble
Getting Started: WiVRn
You will need a custom version on WiVRn: WiVRn-FT
Once WiVRn-FT is running, start the Latest OscAvMgr-WiVRn Build
Getting Started: ALVR
If you have a Quest Pro:
- In ALVR, enable
VRCFaceTrackingandLog Tracking.
If you use a Pico 4 Pro:
- In ALVR, enable
VRChat Eye OSCandLog Tracking.
Once SteamVR is running, start the Latest OscAvMgr-ALVR Build
Using with VRChat
A helper software is required, in order to handle OscQuery for us: galister/VrcAdvert.
wget -O VrcAdvert https://github.com/galister/VrcAdvert/releases/latest/download/VrcAdvert
# change this link to if you're not using ALVR
wget -O oscavmgr https://github.com/galister/oscavmgr/releases/latest/download/oscavmgr-alvr
chmod +x VrcAdvert oscavmgr
I recommend using this start script:
#!/usr/bin/env bash
trap 'jobs -p | xargs kill' EXIT
./VrcAdvert 9402 9002 &
./oscavmgr
VRC-Only: Autopilot
This activates when your HMD is in hand-tracking mode. The bottom of the terminal will change from AP-OFF to MANUAL when active.
Turn left-right: Look at the left/right edge of your screen
Jump: Look at the top edge of your screen
Toggle Mute: Raise your eyebrows
Move forward: Puff up your cheeks
Move backwards: Suck with your cheeks
VRC-Only: Gogo Loco integration
Auto loco switch:
- Switches walking animations off when in full-body mode.
Pose save:
- Saves the idle stand/crouch/prone pose between avatars.
Quick-ascend:
- While in Gogo flight mode, put both hands (controllers) above your head to ascend at a super-high speed.
VRC-Only External Storage
This allows you to save infrequently used sync parameters in oscavmgr, so that they don't take up sync param space on your avatar.
Your corresponding animator state machine must be Write Defaults OFF for this to work.
Requires 4 parameters:
ExtIndexkey/name of the parameter to be savedExtValuevalue of the parameter to be savedIntIndexkey/name of the variable coming from oscavmgrIntValuevalue of the parameter coming from oscavmgr
To set a value:
- Set
ExtIndexto an integer. This will be the key/name of your parameter. - Set
ExtValueto a float. This is the value saved. This float can be 0/1 when saving a bool, or a number higher than 1 when saving an int.
To read a value:
- Have
ExtIndexon 0 (otherwise oscavmgr will be stuck waiting for your input). - oscavmgr will iterate through all of your saved parameters and send them back to VRC (and other players) one at a time.
- In your avatar's FX animator, make a decision tree to handle the
IntValueifIntIndexcorresponds to a known value.
Using with Resonite
Enable this mod: galister/EyeTrackVRResonite (This is a fork that supports both Eye + Face)
With the mod enabled, simply start OscAvMgr.
A set of DynamicValueVariables will be created for you. Use them to drive your choice of blendshapes. (Network syncing is already handled for you).
If you are starting up Resonite after using VRC, you will need to restart OscAvMgr, or it will keep sending the set of parameters from your last VRC avatar!
Pico 4 Pro Users: Your eyes will be always closed. To fix this, remove the eyelid blendshapes from your EyeManager, and create a second EyeManager (not driven by OscAvMgr) to drive the eyelids.
Building from Source
We recommend using rustup. If your compile is failing, try updating your toolchain using rustup update stable.
Build for WiVRn:
cargo build --release --no-default-features --features=wivrn
Build for ALVR:
cargo build --release --no-default-features --features=alvr
Build for Project Babble:
cargo build --release --no-default-features --features=babble