Ports

Every port Vfinity uses, what listens on it, and which direction the connection goes.

Four ports, all local. Which side opens the connection differs, and that is the part worth knowing when something will not connect.

Port	Used for	Vfinity's role	Set in
`8001`	VTube Studio plugin API	Client. Vfinity connects to VTube Studio	SettingsConnections, VTube Studio API card
`21424`	The OBS overlay server	Server. OBS connects to Vfinity	SettingsConnections, Throw Item Overlay card
`21213`	A custom TikTok connector	Client. Vfinity connects to your connector	SettingsConnections, TikTok LIVE card, custom mode only
`8080`	The trigger API	Client. Vfinity connects to your server	SettingsConnections, Trigger API card

8001VTube Studio plugin APIClient
VfinityVTube Studio
Vfinity connects out
21424The OBS overlay serverServer
VfinityOBS
OBS connects in to Vfinity
21213A custom TikTok connectorClient
VfinityYour connector
Vfinity connects out · custom mode only
8080The trigger APIClient
VfinityYour server
Vfinity connects out

Vfinity listens on exactly one port. Everything else it dials out to, so a connection that will not open is usually the other side not running.

What that means in practice

Vfinity is a server on exactly one port, 21424. Everything else it dials out to.

So if the trigger API will not connect, the question is whether your server is running, not whether Vfinity is listening. Vfinity never listens on 8080. Same for VTube Studio: 8001 is VTube Studio's port, and Vfinity is the one knocking.

When 21424 is taken

Vfinity picks another free port at startup and tells you. The Dashboard and every widget card always show the URL that is actually live, so copy from there rather than assuming 21424.

To pin it, set Overlay Port in SettingsConnections and restart Vfinity. If your preferred port is busy at the next launch, it falls back again.

The built-in TikTok bridge

The built-in bridge is a background process Vfinity starts and talks to directly. It does not use a port you configure, and it is not the same as the 21213 custom connector port. See Connection modes.

Nothing is exposed to the internet

The overlay server binds to 127.0.0.1 and checks the origin of incoming connections. Other machines on your network cannot reach it, and neither can anything outside.

Overlay URLs

What runs on 21424.

Trigger API

The protocol on 8080.