← TallyHub Pro

Getting Started

Set up your TallyHub system in minutes

1

Download & Install

Choose the right version for your operating system:

macOS (Apple Silicon)

M1, M2, M3 Macs

macOS (Intel)

Intel-based Macs

Windows

Windows 10/11

Linux Server

Standalone server

⚠️ macOS Users:

If you see "TallyHub is damaged", run this command in Terminal:

xattr -cr /Applications/TallyHub.app
2

Connect Your Mixer

TallyHub supports multiple video mixers:

OBS Studio

  1. Enable WebSocket server in OBS: Tools → WebSocket Server Settings
  2. Set port to 4455 (default)
  3. In TallyHub, add OBS mixer with your computer's IP

Blackmagic ATEM

  1. Connect ATEM to your network
  2. Note the ATEM's IP address
  3. In TallyHub, add ATEM mixer with the IP address

vMix

  1. Enable Web Controller in vMix settings
  2. Set port to 8088 (default)
  3. In TallyHub, add vMix mixer with your computer's IP
3

Choose Your Tally Display

TallyHub works with multiple display options:

📱 Option 1: Phone/Tablet (No Hardware Needed)

Use any smartphone, tablet, or computer as a tally light instantly:

  1. 1. Open a web browser on your device
  2. 2. Navigate to http://<tallyhub-ip>:3000/tally
  3. 3. The page will show LIVE/PREVIEW status with color indicators
  4. 4. Tap fullscreen for maximum visibility

✓ Perfect for testing, backup tallies, or low-budget productions

💡 Option 2: Dedicated ESP32 Hardware

Purchase one of these supported ESP32 devices for a permanent solution:

M5Stick Tally

~$15

  • • Compact
  • • Built-in battery
  • • Easy to mount
Find on AliExpress

M5Stick Plus2

~$25

  • • Larger display
  • • Better battery
  • • USB-C
Find on AliExpress

ESP32-1732S019

~$12

  • • 2.4 inch touchscreen
  • • Very affordable
  • • Bright display
Find on AliExpress
4

Flash Firmware

TallyHub includes a built-in firmware flasher:

  1. Connect your ESP32 device via USB
  2. Open TallyHub and click "Flash Firmware"
  3. Select your device type (M5Stick, ESP32-1732S019, etc.)
  4. Choose "Download from GitHub" for latest firmware
  5. Click "Flash" and wait for completion
5

Configure WiFi

After flashing, configure your tally light's WiFi:

  1. Device boots into AP mode (creates its own WiFi network)
  2. Connect to the device's WiFi network (e.g., "TallyHub-XXXX")
  3. Browser opens automatically to configuration page
  4. Enter your WiFi credentials and TallyHub server IP
  5. Device will restart and connect to your network
6

Assign Camera Numbers

In TallyHub admin panel:

  1. Go to Admin Panel (http://localhost:3000/admin)
  2. Connected devices appear automatically
  3. Assign each device to a camera/input number
  4. Devices will now show tally states from your mixer

You're All Set! 🎉

Your tally lights should now be responding to your video mixer. Need help?

Report an IssueView Documentation