DMX Triggers

Fire audio cues directly from your lighting console. Map DMX channels to carts and players.

Overview

BPSoundscape can receive DMX via sACN (E1.31) or Art-Net. Map channels to trigger carts or control player volumes.

Trigger Modes

Mode	Behavior
Flash	Channel > 127 = trigger, < 127 = stop
Toggle	Rising edge (0→255) toggles play/stop
Level	Channel value (0-255) controls volume

🌐 Web UI

Configure DMX Input

Go to Settings → DMX
Enable sACN Input or Art-Net Input
Set the Universe to listen on

Map Channel to Cart

Click on a cart to open settings
Go to Triggers tab
Set DMX Channel (1-512)
Choose Trigger Mode

⌨️ CLI

Enable DMX Input

bpsoundscape config set dmx.sacn.enabled true
bpsoundscape config set dmx.sacn.universe 1

Map Channel to Cart

bpsoundscape cart trigger-map --page 1 --slot 1 --dmx-channel 1 --mode flash

List Mappings

bpsoundscape dmx mappings

🔌 HTTP API

Configure DMX Input

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

Create Mapping

curl -X POST http://localhost:8513/api/v1/dmx/mappings \
  -H "Content-Type: application/json" \
  -d '{
    "channel": 1,
    "target": "cart:1:1",
    "mode": "flash"
  }'

📡 OSC

DMX Config via OSC

Address	Args	Description
`/bpsoundscape/dmx/sacn/enable`	int (0/1)	Enable sACN input
`/bpsoundscape/dmx/sacn/universe`	int	Set sACN universe
`/bpsoundscape/dmx/artnet/enable`	int (0/1)	Enable Art-Net input

Examples

# Enable sACN input on universe 5
oscsend localhost 8514 /bpsoundscape/dmx/sacn/enable i 1
oscsend localhost 8514 /bpsoundscape/dmx/sacn/universe i 5

Console Setup Tips

MA — Use sACN output, map channels to executor buttons
ETC — sACN output, use submasters or channels
GrandMA3 — Network protocols → sACN output

← OSC Triggers Timecode Triggers →