← TallyHub Pro

Documentation

Complete guide to using TallyHub Pro

📱

Browser Tally

Use phone/tablet as tally light

📦

Installation Guide

Install on macOS, Windows, or Linux

🚀

Getting Started

Quick start guide and setup

⚡

Flash Firmware

Flash firmware to ESP32 devices

🐳

Docker Deployment

Run with Docker on Pi or server

👨‍💻

Developer Guide

Contributing and API docs

💻

GitHub Repository

Source code and issues

System Requirements

  • • macOS 10.15+ (Intel or Apple Silicon) or Windows 10/11
  • • Network connection (WiFi or Ethernet)
  • • Compatible video production software (OBS Studio, vMix, ATEM, etc.)
  • • ESP32-based hardware or Raspberry Pi for tally lights

Supported Platforms

OBS Studio

Full Support

vMix

Full Support

ATEM Switchers

Full Support

TriCaster

Coming Soon

Hardware Options

Browser-Based Tally

Use any phone, tablet, or computer as a tally light - no additional hardware needed

  • ✓ Works on any device with a browser
  • ✓ Instant setup - just open a URL
  • ✓ Perfect for testing or low-budget setups
  • ✓ Fullscreen mode for maximum visibility

ESP32 Tally Light

Cost-effective wireless tally light using ESP32 microcontroller

  • ✓ WiFi connectivity
  • ✓ RGB LED support
  • ✓ Low power consumption
  • ✓ Easy firmware updates

Raspberry Pi Tally Light

Powerful tally light with display capabilities

  • ✓ HDMI/LCD display support
  • ✓ Network connectivity
  • ✓ Custom UI options
  • ✓ Extensible platform

Configuration

TallyHub can be configured to work with various video production systems:

  1. 1. Launch TallyHub application
  2. 2. Select your video production software from the list
  3. 3. Configure connection settings (IP address, port, etc.)
  4. 4. Add your tally light devices
  5. 5. Map cameras to tally lights

Troubleshooting

Issue: Tally lights not connecting

Solution: Ensure all devices are on the same network and check firewall settings

Issue: macOS security warning

Solution: Run: xattr -cr /Applications/TallyHub.app in Terminal

Issue: Delayed tally response

Solution: Check network latency and reduce WiFi interference

Device Discovery

Tally devices automatically discover the hub using a two-stage strategy:

1. UDP Broadcast Discovery

Devices send a discovery packet to the subnet broadcast on UDP port 7411. The hub replies with its IP address and ports.

  • • Port: 7411/UDP
  • • Fast and reliable on same subnet
  • • Works across most network configurations

2. mDNS Fallback

If UDP discovery fails, devices query for _tallyhub._udp.local service.

  • • Service: _tallyhub._udp.local
  • • TXT records: api=3000, udp=7411, ver=1.2.0
  • • Zero-configuration networking

Manual Configuration: If automatic discovery fails (VLANs, enterprise networks), you can manually configure the hub IP address in the device's AP mode.

Recent Firmware Improvements

September 2025 Updates

  • ✓ Unified battery smoothing & percent logic across M5StickC Plus and Plus2
  • ✓ Always-on Wi-Fi outline and disconnect indicator for clearer status
  • ✓ Removed legacy battery calibration/debug mode for leaner firmware
  • ✓ Overlap-safe layout for battery percent and Wi-Fi icon
  • ✓ Improved stability and performance

API & Integration

TallyHub provides REST and WebSocket APIs for custom integrations.

WebSocket endpoint for real-time tally updates:

ws://localhost:3000/api/tally

Common REST endpoints:

  • GET /api/devices - List devices
  • POST /api/devices - Register device
  • GET /api/assignments - Camera assignments

For detailed API documentation, see the Developer Guide.

Version Information

Current Version

1.2.0

Latest release includes firmware improvements, Docker optimizations, and enhanced device discovery.

View Release Notes

Support

Need help? Here are your support options: