Art-Net & sACN

Overview

BPTimecode supports timecode over Art-Net and sACN (E1.31). This is useful for:

• Media servers — Sync video playback (Resolume, Millumin, etc.)
• Visualizers — Sync previs with timecode
• Lighting consoles — Trigger cues from timecode

Timecode is sent in Art-Net TimeCode format (4 bytes: frames, seconds, minutes, hours).

🌐 Web UI

Configure Art-Net Output

1. Go to Settings → Protocols → Art-Net
2. Enable Art-Net Output
3. Set Broadcast Address (default: 2.255.255.255)
4. Route a slot to artnet:0 in the routing matrix

Configure sACN Output

1. Go to Settings → Protocols → sACN
2. Enable sACN Output
3. Set Universe for timecode data
4. Route a slot to sacn:1 in the routing matrix

⌨️ CLI

Enable Art-Net

bptimecode config set artnet.enabled true
bptimecode config set artnet.broadcast "2.255.255.255"

Enable sACN

bptimecode config set sacn.enabled true
bptimecode config set sacn.universe 1

Route to Art-Net

bptimecode route create --source slot:1 --dest artnet:0

Route to sACN

bptimecode route create --source slot:1 --dest sacn:1

🔌 HTTP API

Endpoints

Configure Art-Net

curl -X PUT http://localhost:5050/api/v1/artnet/config \
  -H "Content-Type: application/json" \
  -d {"enabled": true, "broadcast": "2.255.255.255"}

Configure sACN

curl -X PUT http://localhost:5050/api/v1/sacn/config \
  -H "Content-Type: application/json" \
  -d {"enabled": true, "universe": 1, "priority": 100}

📡 OSC

Addresses

Examples

# Enable Art-Net output
oscsend localhost 5051 /bptimecode/artnet/enable i 1

# Enable sACN on universe 5
oscsend localhost 5051 /bptimecode/sacn/enable i 1
oscsend localhost 5051 /bptimecode/sacn/universe i 5