The setup wizard
Five short steps from a fresh install to a gift that moves your model, and how to run them again
The setup wizard connects VTube Studio and your streaming platforms, adds the OBS browser source, and sends a test gift so you can see the whole path work. It opens by itself the first time you start Vfinity.
Move through the steps
A row across the top of Set up Vfinity names each step and marks it Done, Waiting, Not yet or Skipped. The marks come from the live connections, so a step only reads Done while that connection really works. Click a step in the row to go straight to it.
At the bottom, Back and Next move one step, Skip this step passes over the one you're on, and the last step has Finish. Each step has a Why this step note; rest the pointer on its question mark to read it.
Work through the five steps
Connect VTube Studio
In VTube Studio, open the settings gear, find the plugin API and switch Start API on. The wizard shows the port it expects, 8001 unless you changed it. Then click Connect to VTube Studio.
VTube Studio asks whether to allow Vfinity. Choose Allow. That window can open on another monitor, or behind VTube Studio itself.
Without VTube Studio, only model reactions are unavailable, so you can skip this step and come back to it. Connect VTube Studio
Enter your TikTok username
Type Your TikTok username without the @, and click Connect. If you aren't live, Vfinity waits for your LIVE and joins the moment you start, so you can leave it waiting and carry on.
You don't have to be live to finish setup. Skip this step and press Connect on the Dashboard when you go live.
Add Twitch, Kick or YouTube
This step is optional: skip it if you only stream to TikTok. Otherwise click Open connection settings. The wizard closes and Settings opens at your connections, and the wizard opens on this step again the next time Vfinity starts. Connect your platforms
Add the OBS browser source
The wizard gives two addresses, Thrown gifts and Alerts, each with a copy button. In OBS or TikTok LIVE Studio, go to Sources, click +, choose Browser, paste an address and set the size to 1920 by 1080.
The step turns green the moment a source opens its address. You can skip it: both addresses are also on the Overlay tab. Add your first overlay
Send a test gift
Click Send a test gift. It sends a Rose along the path a real gift takes, through your events, the throw and the alert, so what happens here is what happens on stream. Click Send another to try again.
Read the test results
The last step reports what the Rose did, one line at a time.
| You see | What it means |
|---|---|
| The gift went through the app. | The gift arrived. This is the part that has to work. |
| A mapping fired a hotkey on your model. | An event reacted to the Rose in VTube Studio. |
| No model reaction. | No event reacts to a Rose yet. Add one on the Events tab. |
| The throw reached your browser source. | An OBS source is open and received the throw. |
| Nothing reached the browser source. | Add the source in the step before, and turn a gift into a throw on the Throwing tab. |
| Nothing came back. | Check the TikTok step, then send another. |
A missing model reaction or throw doesn't mean setup failed. It means nothing is set up to react yet, which the next guides cover.
Close it and come back later
Click the close button in the corner to leave for now. Progress saved means the wizard opens on the same step the next time Vfinity starts.
To stop it opening by itself, click Skip setup. Everything the wizard does can also be done from Settings.
Run setup again
A finished or skipped wizard opens only when you ask for it. Any of these opens it:
- In the Dashboard's Connections card, click Run setup again. If the card says Ready to go live, click Show details first.
- Right-click Dashboard in the dock and choose Run setup again.
- Press Ctrl+K/Cmd+K and type "setup".
A wizard you finished starts again from the first step. One you closed partway picks up where you left it. If you upgraded from 1.x, the wizard never opened by itself, and this is how you run it.