dragonflight/sdk/blackmagic/README.md
Zac Gaetano fffff1c016 feat(cluster): install capture-card drivers/SDKs from the admin screen
Per-node "Capture Drivers / SDKs" panel installs Blackmagic / AJA / Deltacast
/ NDI drivers without SSH. node-agent gains NODE_TOKEN-gated /driver/install
+ /driver/status (spawns a one-shot privileged ubuntu container that bind-
mounts host kernel paths + the repo and runs deploy/install-driver.sh);
mam-api adds admin-gated /cluster/:id/install-driver + /driver-status.
Driver files live in-repo under sdk/<vendor>/ (private repo); binaries are
admin-supplied per each sdk/<vendor>/README.md. Vendor allowlist throughout.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-05-31 18:14:59 -04:00

1.3 KiB

Blackmagic Desktop Video (DeckLink) driver

Drop the Blackmagic Desktop Video Debian package for Ubuntu 22.04 (x86_64) into this directory.

Required file

File Notes
desktopvideo_*_amd64.deb The desktopvideo package from the Desktop Video installer archive. Provides the blackmagic kernel module (built via DKMS) and the DesktopVideoHelper daemon.

Example name: desktopvideo_14.4.1a4_amd64.deb

The installer reads the newest matching desktopvideo_*_amd64.deb if more than one is present.

Where to get it

Blackmagic Design → Support → Desktop Video (Linux). Download the "Desktop Video x.y.z Linux" tarball, extract it, and copy the deb/<arch>/desktopvideo_*_amd64.deb file here.

Optional: desktopvideo-gui_*_amd64.deb is not required for headless capture and is not installed.

What the install script does

  1. Ensures linux-headers-$(uname -r) is present (needed for the DKMS build).
  2. apt-get install -y ./desktopvideo_*_amd64.deb (pulls DKMS deps).
  3. Triggers the DKMS build, depmod, modprobe blackmagic.
  4. Restarts the DesktopVideoHelper daemon.
  5. Verifies /dev/blackmagic appears.

A reboot is usually not required but a DKMS rebuild against a freshly installed kernel may need one — the script reports this.