Vfinity documentation
Connect your TikTok LIVE to VTube Studio, throw gifts at your model, and put overlays in OBS.
Vfinity is a desktop app that watches your TikTok LIVE room and turns what viewers do into something your VTube Studio model does. A gift can press a hotkey, move the model, switch a VFX preset, or fly across the screen and bounce off your avatar's head. OBS gets overlays for chat, alerts, goals and leaderboards.
It runs on Windows, macOS and Linux, it is free, and it needs no account.
Start here
Install Vfinity
Download the right file for your operating system and get past the first-run warning.
Connect VTube Studio
Turn on the plugin API, approve Vfinity once, and confirm the light goes green.
Connect TikTok LIVE
Point Vfinity at your username, or at a connector you already run.
Make your first reaction
Map a like to a hotkey and fire it from the event simulator, with no live stream needed.
Find your way around
How-to guides
One task per page: tune throwing physics, add an overlay widget, read chat aloud, back up your settings.
Reference
Every event type, action, mapping field, overlay widget, port and default value.
Concepts
What happens between a viewer tapping a gift and your model reacting, and what stays on your machine.
Troubleshooting
The connection will not go green, nothing throws, OBS shows a blank source.
Which version this describes
These pages describe Vfinity 1.5.0, the current download. The changelog in the app, under the bell icon in the title bar, is the authority on what your copy actually has.