This guide creates a first end-to-end tally path from an ATEM connection to a TSL-compatible multiviewer or UMD display.
The finished path works like this:
ATEM Program or Preview state→ Tally Provider for the affected ATEM input→ Program or Preview Tally Channel on that source port→ Tally Consumer watching an ATEM destination→ TSL client connection→ Multiviewer or UMD display
The Provider translates ATEM state into tally state inside Buttons. The Consumer watches a destination, follows its active source, resolves that source's label and Tally Channels, and sends the result to the external display.
A non-production ATEM connection that is online in Buttons.
ATEM source and destination routing resources.
A TSL-compatible multiviewer or UMD display.
The display's IP address, TSL port, supported TSL version and transport, UMD address, and screen number where applicable.
A destination that can be changed without affecting a production output.
This guide uses Input 2 as the source and ME 1 Program as the destination. Substitute resources reserved for your own setup work.
Warning
Consumer Test Mode sends output through the configured TSL connection. Use a non-production UMD address and make sure temporary labels or tally indications cannot be mistaken for live production state.
Tally Channels give operational meaning to tally state. In this setup, Providers activate Program or Preview, and Consumers map those channels to UMD indicators.
Open Routing → Tally / UMD.
Open Channels.
Select Add.
Under Or quick add a preset, select Preview.
Select Add again.
Select the Program preset.
The presets create:
Preview, with short label PVW and a green color.
Program, with short label PGM and a red color.
If these channels already exist, use the existing channels rather than creating duplicates. The switcher Quick Setup recognizes channels named Program and Preview and selects them for the corresponding ATEM roles.
The ATEM knows whether each input contributes to Program or Preview. Quick Setup creates Providers that read those connection feedbacks and apply the matching Tally Channel to each ATEM source port.
Open Providers.
Select Quick Setup.
Select Generate tally from a switcher (ATEM, etc.).
Under Switcher Connection, select the non-production ATEM.
Wait for Buttons to read the available inputs and Program/Preview suggestions.
Under Program tally channels, confirm Program.
Under Preview tally channels, confirm Preview.
Review the number of Providers that will be created.
Select Create Providers.
Quick Setup creates one Provider for each suggested input and each mapped role. Each Provider:
Watches an ATEM Program or Preview feedback for one input.
Uses the corresponding ATEM source port as its subject.
Activates the selected Tally Channel when that feedback is active.
Tip
Map only the Program and Preview roles you need. Quick Setup creates one Provider per input for every mapped role, so omitting an unused role avoids unnecessary Providers.
Use a non-production ATEM route or switcher operation to place Input 2 on the selected Program destination.
Open Active under Tally / UMD.
Find the Input 2 source port.
Confirm that Program appears under Active Channels.
Confirm that the corresponding ATEM Provider appears under Responsible Providers.
Change the ATEM state away from Input 2.
Confirm that its Program tally clears or moves to the newly active source.
This proves the first half of the path: ATEM state is reaching a Provider and becoming a Tally Channel on the correct source port. It does not yet prove that the UMD output is configured.
A TSL client connection sends labels and tally indications from Buttons to the multiviewer or UMD display.
Open TSL Connections.
Select Add.
Enter a Label, such as Studio 2 Multiviewer.
Set Connection Type to Client (Connect).
Enter the display's IP address or hostname under Host.
Enter the display's TSL Port.
Select Create.
Open the new connection.
Under Protocol, select the TSL version and transport required by the display.
Save the connection.
Confirm that the connection does not show Unconfigured or Error.
New connections use TSL 5.0 UDP unless changed in the connection details. Match the display's configuration rather than assuming its protocol.
For UDP output, Buttons can transmit without receiving an acknowledgement from the display. A healthy connection status therefore does not prove that the display is using the messages; verify the result on the display itself.
The Consumer watches ME 1 Program. Its Active Source lookups follow the current source routed to that destination. If Input 2 is active there, the Consumer resolves the Input 2 label and the Program or Preview channels attached to that source.
Open Consumers.
Select Quick Setup.
Select Generate TSL outputs for ports / bundles.
Select the TSL client connection created for the display.
Continue to the mapping step.
Select Add Ports / Bundles.
Select Destinations.
Choose Bundles or Ports to match how the display tile represents the signal.
Select the non-production ME 1 Program destination.
Select Add Selected.
Enter the UMD Address and Screen expected by the display.
Continue to TSL UMD Setup.
Leave Resolved Label Preset set to Active Source.
Leave Resolved Tally Preset set to Active Source.
Under Tally Channel → TSL UMD, confirm the intended mappings. By default, Buttons maps:
Preview to Left using the channel color.
Program to Right using the channel color.
Continue to Review.
Confirm the generated Consumer label.
Create the Consumer.
Use the UMD address and screen configured on the external display. The first generated mapping starts at address 0 and screen 0, but those defaults are not a statement about the display's configuration.
Test Mode lets you verify the Consumer's label and tally mapping independently of current ATEM state. It drives the real configured output, so keep the test brief and identifiable.
Open Consumers.
Open the generated Consumer for ME 1 Program.
Turn on Test Mode.
Under the Program Tally Lookup, turn on Active in test.
Under Label Lookups, enter a clear Test value, such as TALLY TEST.
Save the Consumer.
Confirm that the intended UMD tile shows the test label and Program indication in the configured position and color.
Turn off Test Mode.
Save the Consumer again.
Confirm that the temporary test state clears from the display.
When no individual Tally Lookup is marked Active in test, Test Mode activates all configured Tally Lookups. Marking the Program lookup explicitly keeps this check limited to the intended indication.
Under Active, confirm that the expected source port has the correct Tally Channel and Responsible Provider.
Open the Provider and confirm it is enabled and tied to the expected ATEM input and channel.
Open the Consumer and confirm its Watch Item is the intended destination.
Confirm the label and tally lookups use Active Source.
Confirm the Program and Preview channels map to the intended UMD positions and colors.
Confirm the Consumer's TSL output uses the intended connection, address, and screen.
Open TSL Connections and check the client connection status, host, port, protocol, and enabled state.
Confirm that the external display is configured for the same TSL version, transport, port, address, and screen.
Confirm Test Mode is off after setup work is complete.
If Active shows the correct source and channel but the display does not update, focus on the Consumer, TSL connection, and display configuration. If Active is already wrong, correct the ATEM Provider side before investigating the UMD output.
