Dragonflight - self-hosted broadcast media asset management. SRT/RTMP/SDI ingest via Blackmagic DeckLink, FFmpeg proxy generation, growing-file editing via SMB + Premiere Pro CEP panel, BullMQ job queue, S3-compatible storage (RustFS). Replaces Grass Valley AMPP FramelightX.
ZGaetano
bbed2a7059
Two bugs fixed:
1. SDI capture sidecar never had /dev/blackmagic bound — ffmpeg opened the
decklink input inside a container with no device nodes, so frame=0.
Fix: local spawns now push '/dev/blackmagic:/dev/blackmagic' onto Binds
when source_type='sdi'.
2. recorders.js always spawned sidecars against the local Docker socket
(zampp1), even when a recorder's node_id pointed at zampp2 (where the
card is). Fix: resolveNodeTarget() looks up the recorder's cluster node;
if it's a different hostname the sidecar is spawned via a new
POST /sidecar/start endpoint on the remote node-agent.
node-agent gains three new routes (all talk to the local Docker socket):
POST /sidecar/start — create + start container (host network,
privileged, /dev/blackmagic bind for sdi)
DELETE /sidecar/:id — stop + remove
GET /sidecar/:id/status — inspect + poll capture service
docker-compose.worker.yml: add /var/run/docker.sock and LIVE_DIR to
node-agent so it can spawn sidecars, and document build-capture prerequisite.: recorders.js
|
||
|---|---|---|
| deploy | ||
| docs/superpowers | ||
| services | ||
| .env.example | ||
| .gitignore | ||
| docker-compose.gpu.yml | ||
| docker-compose.worker.yml | ||
| docker-compose.yml | ||
| README.md | ||
| setup-repo.sh | ||
Wild Dragon
Self-hosted Media Asset Management platform built to replace Grass Valley AMPP FramelightX.
Services
| Service | Port | Description |
|---|---|---|
| web-ui | 8080 | Browser-based MAM interface + capture controls |
| mam-api | 3000 | REST API — assets, projects, bins, jobs |
| capture | 3001 | SDI capture daemon (Blackmagic DeckLink + FFmpeg) |
| worker | — | Async job processor (proxy gen, thumbnails, conform) |
| db | 5432 | PostgreSQL 16 metadata store |
| queue | 6379 | Redis 7 job queue (BullMQ) |
Quick Start
# Clone
git clone https://forge.wilddragon.net/zgaetano/wild-dragon.git
cd wild-dragon
# Configure
cp .env.example .env
# Edit .env with your S3 credentials and secrets
# Launch
docker compose up -d
# Open
open http://localhost:8080
Architecture
SDI Input (DeckLink) → capture service → dual FFmpeg streams
├─ HiRes (ProRes) → S3
└─ Proxy (H.264) → S3
↓
web-ui ← mam-api ← PostgreSQL ← worker (BullMQ)
├─ proxy_gen
├─ thumbnail
└─ conform (EDL → FFmpeg → export)
Tech Stack
- Backend: Node.js / Express
- Frontend: Vanilla HTML/CSS/JS
- Database: PostgreSQL 16
- Queue: Redis 7 + BullMQ
- Storage: S3-compatible (RustFS)
- Media Processing: FFmpeg
- Capture: Blackmagic DeckLink SDK
- Deployment: Docker Compose
License
MIT