Bitfocus AS
logo
logo
Bitfocus AS
logo
logo
Sign upSign in

Loading...

Bitfocus

Subscribe to our newsletter

The latest news, articles, and resources, sent to your inbox.

FacebookInstagramGitHubYouTubeLinkedIn

Products

  • Buttons
  • Companion

Integrations

  • Supported Devices
  • Developer Community
  • Connection Development

Support

  • Support Overview
  • Documentation
  • Video Tutorials
  • Community Forum

Sales

  • Resellers & Integrators
  • Buttons Pricing

Updates

  • Case Studies
  • Events & Trade Shows
  • Press Releases
  • Product Updates
  • Webinars

Legal

  • Legal Overview
  • Privacy Policy
  • Buttons EULA
  • Terms & Cookie Policy

Company

  • About us
  • Press kit
  • Careers

© 2026 Bitfocus AS. All rights reserved.

Diagnose tally problems
Docs for
Overview
Getting started
What is Bitfocus Buttons?
Install Buttons and get started
Manage your Buttons license
Activate Buttons offline
Find your way around Buttons
Create your first backup
Add an ATEM connection
Choose a control method
Choose an installation path
Install Buttons on Debian or Ubuntu
Understand HA clustering
Kubernetes HA
Update or remove Buttons
Positions
Understand positions
Create a position
Add controls and sections to a position
Create your first button
Use a connection's presets
Build more capable button actions
Add more feedback to a button
Organize controls in a section
Shift Section
Organize controls with a Folder Section
Add a Popover Section
Build and reuse a Shared Section
Build a Router Section
Understand Custom Routers
Custom Router panel
Surfaces
Surface compatibility
Add and attach a surface
Device orientation
Connections
Update a connection's module safely
Monitor and troubleshoot a connection
Router integrations
VideoHub and AJA KUMO
Utah Scientific BPS
Generic SW-P-08
Nevion VideoIPath
Arkona BLADE//runner
Routing
Physical routing
Configure ports and labels
Take a physical route
Understand route status
Topology graph
Routing Presets
Get started with virtual routing
Configure Nested Shapes
Reverse routing
Tielines
Routing Projects
Routing settings
Troubleshoot a route
Tally
Understand the Tally system
Send ATEM tally and labels to a UMD
Interpret Active Tally state
TSL/UMD connections
Diagnose tally problems
NMOS
Understand NMOS in Buttons
Connect Buttons to an NMOS Registry
Built-in Registry Server
Configure NMOS connections
Discover and adopt
Browse the NMOS inventory
Manage NMOS multicast addresses
Diagnose NMOS problems
Understand Cuelists
Build a Cuelist
Read and advance a running Cuelist
Control a Cuelist from a Position
Workflows
Understand workflows
Build your first workflow
Reuse a group of workflow nodes safely
Troubleshoot a workflow
Recipes
Sequence a timed automation
Call an HTTP endpoint from a workflow
REST endpoint
Use variables
Understand variable scope
Understand nested variables
Update expressions for v1.8
Plan and use Tags
Access
Create and manage users
Create roles and assign permissions
Grant access to specific resources
Show different controls by role
Sessions
Set up PIN and NFC sign-in
SSO
Get started with SSO
Connect a generic OIDC provider
Connect LDAP or Active Directory
Map identity claims to roles
Secure a Buttons deployment
Integrations
External control
Connect to Bitfocus Listener
USB Relay
Install USB Relay on Windows
Install USB Relay on macOS
Install USB Relay on Linux
Install USB Relay on a Raspberry Pi
Get started with the Control API
Secure and monitor the Control API
Control API reference
API reference
Administration
Enable and manage installable features
Services and health
Configure and monitor scheduled backups
Restore a backup and verify it
Export or import Buttons configuration
Store and rotate connection secrets
Replace the HTTPS certificate
HA backup and recovery
Settings
Collect support information
Reference
Glossary
Button Inspector reference
Network ports reference
Expressions
Internal actions reference
Routing Presets panel reference
Startup configuration reference
Workflow nodes
Connection workflow nodes
Workflow workflow nodes
Internal workflow nodes
Position workflow nodes
API workflow nodes
Utility workflow nodes

Loading...

Previous
← TSL/UMD connections
Next
NMOS →
Contact support →
You are viewing documentation for Buttons 1.8.See the docs for Buttons 1.6
Buttons/Tally/Diagnose tally problems

Diagnose tally problems

When tally or a label is missing, stale, duplicated, or wrong, Buttons can help you find exactly which stage of the model broke instead of guessing at the whole chain. Work through the same sequence the Tally system uses (input, Provider, Active, Consumer, Reaction) and check each stage before assuming the next one is at fault.

Missing tally#

  1. Open Routing → Tally / UMD → Active and confirm the expected port shows the expected Channel at all. If it doesn't, the problem is on the Provider side, not the Consumer.
  2. Open the Provider and confirm it's enabled, its condition actually matches the current input state, and its Target Ports / Bundles resolve to the port you expect.
  3. If the Provider's condition is Feedback, confirm the connection it watches is healthy: a degraded connection can silently stop reporting feedback with no error visible unless you check the connection's own status.
  4. If the Provider's condition is TSL Server Input, confirm the TSL connection is a Server (Listen) connection actually receiving data: see Send or receive tally and labels over TSL/UMD.
  5. If Active looks correct but nothing reaches the display, move to the Consumer: confirm its Watch Item, that its Tally Lookup's relation and filter actually select the Channel you expect, and that its Reaction targets the right TSL connection, address, and screen.

Stale tally#

Tally shown on Active is only as current as the Provider's own input. A device's own feedback doesn't always update the instant its state changes: a connection can silently stop reporting new feedback while otherwise looking healthy.
  1. Change the real input state again and confirm Active updates. If it doesn't move at all, suspect the connection's feedback subscription rather than the Provider's configuration.
  2. Check the connection's own status and logs: a connection that's degraded or reconnecting can leave tally on its last known value with no error surfaced through the tally model itself.
  3. If a Consumer's displayed result lags behind Active, confirm its relation actually follows the routing you expect: a Selected Watch Item lookup only ever shows its own port, so a route change elsewhere in the chain won't move it.

Duplicated or unexpectedly combined tally#

  1. Open Active and check Responsible Providers for the port: more than one Provider contributing at once is expected behavior, not a fault, but it explains why a Channel stays active after only one condition clears. See Interpret Active Tally state.
  2. If a Consumer shows more indications than intended, check its Tally Lookup's Filter Mode: a broader filter than intended picks up Channels you didn't mean to include.
  3. If a single change updates more destinations than expected, check whether a Provider's subject uses Active Destinations or Active Sources expansion: that deliberately spreads tally to every fed destination or feeding source, not just the immediate port.

Incorrect or missing labels#

  1. Confirm the Consumer's Label Lookup uses the relation you expect: the same Selected Watch Item / Active Source / Active Destination distinction that applies to tally also applies to labels, and a mismatch here is a common cause of a label that doesn't follow the route the way the tally does.
  2. Check Label Target (Port or Bundle) and confirm it matches how the underlying resource is actually organized.
  3. If a label looks generic or unexpected, check the label resolution's fallback order: Buttons falls back through configured label types when a specific one isn't set, so a missing custom label can surface a different label type than you expected rather than an empty result.

TSL connection problems#

See Send or receive tally and labels over TSL/UMD for connection-specific failures: unreachable hosts, a Server (Listen) connection that never receives anything, and protocol mismatches.

Safe test-mode cleanup#

Provider Test Mode and Consumer Test Mode both force state active for verification, and both need to be turned off deliberately once you're done: neither times out on its own.
  1. Open the Provider or Consumer with Test Mode on.
  2. Turn Test Mode off.
  3. Save.
  4. Confirm on Active, or on the display itself, that the temporary state actually cleared.
If you locked an individual tally position directly on a TSL connection's Output State or Received State view rather than through a Consumer, use Release All on that connection, or Release All Connections if more than one connection has locked positions: see Send or receive tally and labels over TSL/UMD.

If you get stuck#

What you see
What to try
A Channel never appears on Active.
Check the Provider first: its condition, target ports, and (for Feedback or TSL Server Input conditions) the health of what it watches.
Active is correct, but nothing reaches the display.
Move to the Consumer: its Watch Item, Tally Lookup relation and filter, and Reaction target.
Active doesn't update after a real state change.
Suspect the connection's own feedback reporting rather than the Provider's configuration.
More Channels are active than expected.
Check Responsible Providers for competing Providers, and any Consumer's Filter Mode for an overly broad match.
A label doesn't match what you expect.
Check the Label Lookup's relation, Label Target, and the label fallback order.
Temporary test state won't clear.
Confirm both Test Mode switches are off and saved, and release any individually locked TSL positions.

Where to go next#

  • Understand the Tally system, for the full Provider/Consumer model.
  • Interpret Active Tally state, for reading what a given tally result actually means.

Was this helpful?

Was this helpful?

0 of 0 users found this page helpful