OBS Studio

Voice Tracking connects to OBS via the OBS WebSocket Server, which is built into OBS Studio v28 and later.

Prerequisite

Ensure all scenes and sources are configured in OBS before connecting Voice Tracking. Each camera feed should have its own scene.

Step 1: Enable the WebSocket Server in OBS

1. Open OBS Studio.
2. From the menu bar, click Tools → WebSocket Server Settings.
3. Ensure Enable WebSocket server is checked.
4. Click Show Connect Info.
5. Note the Port (default: 4455).

Step 2: Configure the Switcher Connection

In the Voice Tracking configuration menu, click the Switcher tab and enter:

Field	Value
Switcher Type	OBS Studio
IP Address	IP address of the computer running OBS
Port	WebSocket server port (default: 4455)
Username	Username for OBS WebSocket authentication (if set)
Password	Password for OBS WebSocket authentication (if set)

Step 3: Start the Switcher

Click Start Switcher. A success message will confirm the connection is active.

OBS Scene Mapping

Voice Tracking cuts to OBS scenes, not sources directly. Ensure each camera feed is assigned to its own scene, then map those scenes to zones via the zone assignment interface.

Stopping the Switcher

To disconnect from the switcher at any time:

• Click Stop Switcher in the Voice Tracking toolbar (the same button used to start it).
• The switcher connection will close immediately.
• The microphone connection remains active unless you also click Stop Microphone.

Zone-to-Source Mapping

After the switcher is connected, map each zone to the correct switcher source:

1. Click a zone header on the zone map.
2. In addition to the Camera and Preset dropdowns, a Switcher Source field is available.
3. Select the input/scene number that corresponds to the camera covering that zone.

For multi-camera setups where multiple zones share one camera, assign the same switcher source to each zone within that camera's field of view.

Troubleshooting

Symptom	Likely Cause	Resolution
Start Switcher fails immediately	Wrong IP, port, or credentials	Verify connection settings; confirm switcher is running and reachable
Zones activate but no cuts happen	Switcher connected but sources not mapped	Verify zone-to-source assignments in the zone map
OBS connection refused	WebSocket server not enabled	Open OBS → Tools → WebSocket Server Settings → Enable
Cuts happen with wrong camera	Zone-to-source mapping incorrect	Re-check zone assignments and verify input/scene numbers
Switcher connects but immediately disconnects	Firewall blocking the port	Verify firewall allows traffic on the configured port between the camera and switcher

Next Steps

With the switcher connected, return to Zone Configuration to assign switcher sources to each zone.