Professional Tally Light System¶
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
✨ 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:
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:
- GitHub Issues: Report bugs and request features
- Discussions: Ask questions and share setups
- Wiki: Community-contributed guides and tips
📈 What's Next?¶
- Download the latest release
- Follow the Setup Guide for your first installation
- Flash ESP32 Firmware for hardware devices
- Configure Your Video Mixer connection
- 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.
-
Hardware Setup
Learn about supported devices and get your ESP32 or M5Stick configured.
-
Video Mixers
Connect your favorite video mixer - OBS Studio, vMix, and more.
-
Admin Panel
Explore the powerful web-based admin interface for monitoring and control.
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