Skip to content

Professional Tally Light System

Tally Hub Hero

Tally Hub is a modern, professional tally light system designed for video production environments. Built with TypeScript and featuring a beautiful web-based admin panel, Tally Hub provides reliable tally light control for professional video mixers including OBS Studio and vMix.

🎯 Why Tally Hub?

Tally Hub bridges the gap between expensive commercial tally systems and DIY solutions, offering:

  • Professional Grade: Enterprise-level reliability with real-time tally updates
  • Cost Effective: Use affordable ESP32/M5Stick hardware (~$15-30 per device)
  • Modern Interface: Beautiful gradient-based admin panel with real-time monitoring
  • Flexible Deployment: Run on any computer or server with Node.js
  • Open Source: Fully customizable and community-driven

Admin Panel

Key Features

🚀 Professional Performance

  • Real-time Updates: Sub-100ms tally state changes
  • Automatic Recovery: Device wake-up and reconnection system
  • Enterprise Monitoring: Comprehensive device status and health monitoring
  • Recording Status: Visual indication of recording/streaming states

🔧 Easy Setup

  • Web-based Configuration: No complex software installations
  • One-click Firmware Flashing: Browser-based ESP32 firmware installation
  • Auto-discovery: Devices automatically connect to the hub
  • Assignment Management: Drag-and-drop source assignment

🎨 Modern Design

  • Beautiful Interface: Gradient-based UI inspired by modern design trends
  • Responsive Layout: Works perfectly on desktop, tablet, and mobile
  • Dark/Light Themes: Adaptive interface for any lighting condition
  • Real-time Notifications: Toast notifications and browser alerts

🔌 Video Mixer Support

Mixer Status Features
OBS Studio ✅ Full Support Program/Preview/Recording/Streaming
vMix ✅ Full Support Program/Preview/Recording/Streaming
ATEM 🔄 Coming Soon Program/Preview states
Custom ✅ API Support Full customization via REST API

📱 Device Support

Device Type Cost Features
ESP32-1732S019 ~$15 Built-in display, WiFi, compact design
M5Stick C Plus ~$25 Premium display, battery, professional housing
Web Browser Free Any smartphone/tablet as virtual tally
Custom Hardware Varies Build your own with our open protocol

🏗️ Architecture

Tally Hub uses a modern hub-and-spoke architecture:

graph TB
    VM[Video Mixer<br/>OBS/vMix] --> TH[Tally Hub<br/>Server]
    TH --> WS[WebSocket<br/>Clients]
    TH --> UDP[UDP Devices<br/>ESP32/M5Stick]
    TH --> API[REST API<br/>Third Party]

    WS --> WEB1[Web Tally #1]
    WS --> WEB2[Web Tally #2]

    UDP --> ESP1[ESP32 Tally #1]
    UDP --> ESP2[ESP32 Tally #2]
    UDP --> M5[M5Stick Tally]

    API --> CUSTOM[Custom Integration]

Benefits of this approach:

  • Centralized Control: Single point of configuration and monitoring
  • Scalable: Support for unlimited tally devices
  • Reliable: Hub manages connections and handles device failures
  • Flexible: Mix and match different device types
  • Professional: Enterprise-grade monitoring and management

🚀 Quick Start

Get your Tally Hub system running in minutes:

# Download and run the startup script
Start Tally Hub.bat
# Make executable and run
chmod +x "Start Tally Hub.command"
./Start\ Tally\ Hub.command
# Clone the repository
git clone https://github.com/tallyhubpro/Tallyhub.git
cd Tallyhub

# Install dependencies
npm install

# Start the server
npm run dev

Then visit http://localhost:3000/admin.html to access the admin panel!

📊 System Requirements

Server Requirements

  • Node.js 16.x or later
  • Operating System: Windows 10+, macOS 10.14+, or Linux
  • Memory: 512MB RAM minimum
  • Network: Local network access to video mixer

Device Requirements

  • ESP32 or M5Stick C Plus hardware
  • WiFi Connection to same network as Tally Hub server
  • Power Supply: USB cable or battery pack

🎬 Perfect for Professional Productions

Tally Hub is designed for real production environments:

Live Streaming Studios

  • Multi-camera livestreams with OBS Studio
  • Real-time audience engagement with multiple operators
  • Recording status indication for post-production workflows

Corporate Video Production

  • Professional interviews and presentations
  • Multi-camera corporate events
  • Training video production with multiple angles

Educational Environments

  • Lecture capture systems
  • Distance learning setups
  • Student media production labs

Houses of Worship

  • Live service streaming
  • Multi-camera worship environments
  • Volunteer-friendly operation

Broadcast Facilities

  • Professional studio environments
  • News production workflows
  • Live event coverage

🤝 Community & Support

Join our growing community of video production professionals:

📈 What's Next?

  1. Download the latest release
  2. Follow the Setup Guide for your first installation
  3. Flash ESP32 Firmware for hardware devices
  4. Configure Your Video Mixer connection
  5. Join the Community and share your setup!

  • Get Started


    Jump right in with our quick start guide and have your first tally light working in minutes.

    Quick Start

  • Hardware Setup


    Learn about supported devices and get your ESP32 or M5Stick configured.

    Hardware Guide

  • Video Mixers


    Connect your favorite video mixer - OBS Studio, vMix, and more.

    Mixer Setup

  • Admin Panel


    Explore the powerful web-based admin interface for monitoring and control.

    Admin Guide

Professional Tip

Start with web-based tallies using smartphones or tablets to test your setup before investing in hardware devices. This lets you validate your configuration and understand the system before building physical tally lights.


Made with ❤️ by the Tally Hub community