# BlackMatrix

BlackMatrix is a crosspoint router matrix that unifies Blackmagic ATEM switchers and Videohubs into one shared grid across your entire fleet, and emulates the Videohub control protocol so your existing hardware router. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2666/blackmatrix

## Description

BlackMatrix is a crosspoint router matrix that unifies Blackmagic ATEM switchers and Videohubs into one shared grid across your entire fleet, and emulates the Videohub control protocol so your existing hardware router panels can drive the combined routing.

## Platform availability

Available on 3 of 10 platforms: Unraid, Mac, Windows.

## Desktop and other devices

Mac, Windows.

## Health score

63/100 (Good), based on 3 of 4 factors.
- Maintained: 98 (last commit 12 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)

## Links

- desktop: https://github.com/stoatworks-labs/blackmatrix/releases/latest
- Unraid: https://ca.unraid.net/apps/blackmatrix-1og6bcd1kv92ih?q=blackmatrix
- Official website: https://blackmatrix-demo.stoatworks-labs.com

## Common questions

### Why can't the browser demo route real switchers?

A web page cannot reach a switcher at all. The ATEM protocol is UDP and the Videohub protocol is raw TCP, and a browser cannot open either. Run the app on the show network to route real hardware.

### What Docker networking issue affects device discovery?

BlackMatrix must run with host networking, not Docker bridge mode. In bridge mode the built-in /24 device scan silently sweeps the wrong network, and the Videohub protocol emulation is unreachable from control panels. You can still add devices manually by IP.

### Has a real Videohub control panel been verified to drive it?

No. The project says it has never had a real Videohub control panel driving it. It should be proven on your own kit before it goes near a show.

### How does it decide which sources are legal on which destinations?

It reads availability masks from the switcher for every ATEM input. The masks cover aux, multiviewer, SuperSource art, SuperSource box, and key source, plus ME availability.

---
Source: Our Local Host (https://ourlocalhost.com/app/2666/blackmatrix), the self-hosted and open-source app directory.
