Connect VTube Studio
Turn on VTube Studio's plugin API, approve Vfinity once, and watch the VTS pill turn green
Vfinity moves your model through VTube Studio's plugin API. Switch the API on, approve Vfinity the first time it asks, and your events can play hotkeys and expressions and move your model.
Turn on the plugin API
Open VTube Studio's settings
In VTube Studio, click the gear to open its settings.
Start the API
Find the plugin API section and switch Start API on. Note the port it shows. It is 8001 unless you changed it.
Connect and approve Vfinity
Open the VTube Studio card
In Vfinity, go to SettingsConnections and find VTube Studio
API under Apps. IP Address and Port start as localhost and
8001. If VTube Studio showed a different port, type it here.
Connect
Click Connect VTS. You can also right-click the VTS pill in the title bar and choose Connect.
Allow the plugin
VTube Studio asks whether to allow Vfinity. Choose Allow. If nothing seems to happen, look for that window on another monitor or behind VTube Studio.
You only approve Vfinity once. After that it connects without asking, and with Connect on launch on it connects each time Vfinity starts.
If VTube Studio runs on another computer, type that computer's address in
IP Address instead of localhost.
Look for the green pill
The VTS pill in the title bar shows the connection at a glance. It turns green once VTube Studio has approved Vfinity, and rest the pointer on it to read the state in words.
| The pill | What it means |
|---|---|
| Green | Connected and approved. Events can move your model. |
| Amber | Connecting, or retrying after the connection dropped. The retry count shows beside the label. |
| Red | Not connected. |
Right-click the pill to disconnect, reconnect, or jump to the VTube Studio card in Settings.
This PC
Vfinity connects to the VTube Studio API on port 8001 to press hotkeys and move your model.
Vfinity connects to the WebSocket server built into OBS, port 4455, to switch scenes and show sources.
An OBS browser source opens Vfinity's own server, port 21424, to draw throws, alerts and widgets.
Your scripts reach the Local API on that same port, 21424, with a token.
TikTok LIVE, Twitch, Kick and YouTube are reached over the internet. Vfinity opens each of those connections itself.
Arrow: who opens the connection
Port: who listens for it
See what Vfinity found
The Dashboard's VTube Studio model card shows the loaded model and how many expressions, models, item files, parameters and ArtMeshes the event editors can offer. These lists follow VTube Studio by themselves when you switch models.
- Refresh lists reads them again if they look out of date.
- Reconnect starts the connection over if VTube Studio stops answering.
- Images as VTube Studio items needs a second, one-time permission. Click Allow in VTube Studio and accept its prompt, so Vfinity can load images as items.
- Test hit flinch plays the small flinch a hit gives your model, so you can check it reacts without throwing anything.