Switcher Integration

Integrate a video switcher with the Tally Node system to automatically collect camera Tally information and display it on the receivers. It supports various switchers such as Blackmagic ATEM, OBS Studio, vMix, and OSEE, and you can build a multi-switcher environment using 2 slots.

Supported switchers#

Tally Node v2 supports the following 4 video switchers.

Connection procedure#

ATEM connection#

1. 1
   Open the Switcher page

   Open http://[master-ip]/switcher in a browser
2. 2
   Click the Slot 1 Configure button
3. 3
   Enter the following settings

   • Type: ATEM
   • IP: switcher IP address (e.g. 192.168.1.100)
   • Port: 9910 (default)
   • Max Channels: number of channels to use (1-20, default 8)
   • Interface: Auto or a specific interface
4. 4
   Click Save
5. 5
   Check the connection status

   Verify via the Connected / Disconnected indicator

OBS connection#

1. 1
   Enable the WebSocket server in OBS Studio

   • Tools → Settings → WebSocket Server
   • Port: 4455
   • Set a password (strongly recommended)
2. 2
   On the Switcher page, click Slot 1 Configure
3. 3
   Enter the following settings

   • Type: OBS
   • IP: IP address of the PC running OBS
   • Port: 4455
   • Password: WebSocket password
   • Max Channels: number of channels
4. 4
   Click Save

vMix connection#

1. 1
   Enable the Web API in vMix

   • Settings → Web API → Enable
   • Port: 8099 (default)
2. 2
   On the Switcher page, click Slot 1 Configure
3. 3
   Enter the following settings

   • Type: VMIX
   • IP: IP address of the PC running vMix
   • Port: 8099
   • Max Channels: number of channels
4. 4
   Click Save

OSEE connection#

1. 1
   On the Switcher page, click Slot 1 Configure
2. 2
   Enter the following settings

   • Type: OSEE
   • IP: OSEE switcher IP address
   • Port: 52381
   • Max Channels: number of channels
3. 3
   Click Save
4. 4
   Check the connection health

   • Active: receiving packets (green dot)
   • Timed Out: no packets received (red dot)

Multi-switcher configuration#

Tally Node supports a multi-switcher environment using 2 slots.

Slot structure#

Enable Slot 2#

1. 1
   Toggle the Slot 2 card ON

   On the Switcher page, turn the Slot 2 card toggle switch ON
2. 2
   Click the Slot 2 Configure button
3. 3
   Configure the switcher for Slot 2

   Configure it the same way as above
4. 4
   Click Save

Max Channels per slot#

Max Channels is a per-slot setting. It specifies the number of camera channels provided by the switcher connected to the slot, and this value determines the range of camera sources (Cam 1 ~ Cam N) available from that slot.

• Set it in each slot's Configure dialog (part of the slot settings along with Type/IP/Port).
• Slot 1 and Slot 2 can have different Max Channels values.

Camera mapping#

Camera mapping is a separate stage after the slot setup (above). It uses the configured slot(s) as material to build fixed display positions data of 1-20 (P1-P20). Each position Pn specifies which slot and which camera source to display, and ultimately the receiver (camera_id) corresponding to that position turns on.

Mapping concept#

• The mapping table is always fixed at 20 positions (P1-P20).
• Each position can be assigned a camera number from Slot 1 or Slot 2, or left blank.
• If a slot's Max Channels is 8, you can only select Cam 1-8 from that slot.

Example:

• P1 ← Slot 1 / Cam 1
• P2 ← Slot 1 / Cam 2
• P9 ← Slot 2 / Cam 1 (the first camera of the second switcher)

Mapping procedure#

1. 1
   Click a P1-P20 button

   Click one of the position buttons in the Camera Mapping area
2. 2
   Select an item in the source picker

   • Slot 1: 1 ~ (Slot 1 Max Channels) camera numbers (Cyan)
   • Slot 2: 1 ~ (Slot 2 Max Channels) camera numbers (Rose)
   • Blank: unmap
3. 3
   Click the desired camera number
4. 4
   Click Save Mapping

Advanced settings#

Interface binding#

In a multi-NIC environment, you can force a specific network interface.
You can connect two switchers on different internal networks, e.g. vMix over WiFi and ATEM over Ethernet.

Update Speed (state polling interval)#

Update Speed is how often the web dashboard re-fetches device state. Set it in the System menu (see Web UI). The “Settings changes reflect after up to N s” notice at the top of the Switcher page is determined by this value.

Reconnect#

If the connection drops, you can immediately retry with the Reconnect button.

• Independent reconnect for Slot 1/Slot 2
• No automatic retry on connection failure (manual reconnect required)