Ports
Every port and connection Vfinity uses, which side opens it, and where to change it
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
Every local port and internet connection Vfinity uses, and which side opens it. When something will not connect, the direction tells you which program to check.
Local ports
| Port | Used for | Who opens the connection | Set in |
|---|---|---|---|
21424 | Overlays and the Local API, on one server | OBS and your scripts connect to Vfinity | Shared server port, in SettingsConnectionsLocal server |
8001 | VTube Studio's plugin API | Vfinity connects to VTube Studio | Port, on the VTube Studio API card |
4455 | OBS's WebSocket server | Vfinity connects to OBS | Port, on the OBS Studio card |
8080 | Streamer.bot's WebSocket server | Vfinity connects to Streamer.bot | Port, on the Streamer.bot card |
8080 | The Trigger API | Vfinity connects to your own server | WebSocket Port, on the Trigger API card |
21213 | A custom TikTok connector | Vfinity connects to your connector | WebSocket Port, under Advanced TikTok connection, Custom WebSocket only |
21215 | Kick sign-in | Your browser returns to Vfinity | Fixed |
21424, all the time, for overlays and the Local API. 21215, for up to five
minutes while you sign in to Kick.
8001 to VTube Studio, 4455 to OBS, 8080 to Streamer.bot or your Trigger
API server, and 21213 to a custom TikTok connector.
Every port Vfinity connects out to belongs to another program. If one will not connect, check that the program is running and its server is switched on.
The shared server
Overlays, the Local API's HTTP routes and its event WebSocket all share 21424.
- If
21424is busy at launch, Vfinity picks a free port and tells you. Copy overlay URLs from the app rather than typing the port. - A new Shared server port takes effect after you restart Vfinity.
- The server answers this PC only. With Let OBS on another PC use these overlays on, overlays also answer your home network, and only with their access key.
- The Local API always answers this PC only, and only with its token, even with LAN access on.
Vfinity 1.x opened 21214 for the API and 21213 for its TikTok helper. Neither
is opened any more: move API integrations to the shared port.
Internet connections
These are the services Vfinity connects out to. Nothing on the internet connects in.
| Service | Connects to | When |
|---|---|---|
| TikTok LIVE | TikTok, through the built-in bridge | While connected. The bridge talks to Vfinity through process pipes, with no port |
| Twitch | eventsub.wss.twitch.tv, api.twitch.tv, id.twitch.tv | While connected, and to sign in by device code |
| Kick | Kick's Pusher chat socket, kick.com, api.kick.com, id.kick.com | While connected, and to sign in |
| YouTube | www.youtube.com | While connected, to read the stream and its chat, with no sign-in |
| Microsoft Edge (free) text to speech | speech.platform.bing.com | When text to speech speaks |
| Paid text to speech | api.elevenlabs.io, api.sws.speechify.com, api.murf.ai, api.cartesia.ai, api.fish.audio | When that provider speaks, or lists voices |
| HTTP webhook steps | The address you typed | When the step runs |
Twitch signs in with a short code you approve in your browser, so it needs no local port. YouTube needs no sign-in at all, so it opens no port either.