Skip to content

BlackMatrix v0.1.0

Choose a tag to compare

View all tags
@stoatworks-labs stoatworks-labs released this 21 Aug 18:26
· 31 commits to main since this release
v0.1.0
1c2992e

Superseded by v0.1.1. The desktop app in this release cannot see the local network when launched from the Finder — it is missing the macOS local-network declaration, so LAN traffic is denied silently. Use v0.1.1.

First release.

A crosspoint router matrix across a fleet of Blackmagic ATEM switchers and Videohubs — one grid, with Videohub protocol emulation so hardware router panels drive the same crosspoints.

What it does

  • Every routable bus as a destination: aux outputs, ME program and preview, upstream and downstream keyer fill and key, SuperSource boxes and art, and every multiviewer window. On the ATEM Mini Extreme ISO this is 39 destinations where Blackmagic's own Videohub server on the switcher offers 5.
  • Legality read off the switcher, not from a model table — each input's availability bitmasks decide what may be routed where, so an aux output cannot be routed back onto an aux bus.
  • Real Videohubs as devices in the same fleet and the same grid, with the router's own locks.
  • Salvos across the whole fleet, and ties that make one destination follow another across boxes.
  • Videohub emulation per switcher, so panels, Companion and Blackmagic's software can route it.
  • Source routing — which connector feeds each input channel, on models that offer a choice.
  • Device management and network discovery in the app: no config file editing.
  • Captures: read a switcher's real shape to disk and replay it as a device with no hardware present.

Verified

Against a real ATEM Mini Extreme ISO on 2026-08-21: connected, captured, probed, its matrix served over the Videohub emulation as a 29×39 router, and read back to back against Blackmagic's own Videohub server on the switcher — agreeing on all five destinations they share.

Hardware corrected two rules that shipped wrong in development: multiviewer windows 1 and 2 are not fixed to program and preview, and the aux availability bits say which bus rather than merely "an aux".

Not verified

  • No real Videohub has ever been a device, and no hardware router panel has driven the emulation.
  • Only the ATEM Mini Extreme ISO has been captured. Other models in the simulator carry approximate shapes, marked as such.
  • The desktop app's tray window has not been exercised as a native GUI — the bundled server chain has (it serves the UI from inside the .app).

Installing

The desktop app bundles its own Node runtime; nothing else needs installing. Container users: ghcr.io/stoatworks-labs/blackmatrix. Or run the server directly with npm run build && npm start.

macOS installers are unsigned unless Apple signing secrets are configured, so Gatekeeper will object on first open.

AI-assisted project — see the README.

Assets 9
Loading