Routing

Routing Concepts

BPTimecode uses a simple routing model:

• Sources — Timecode slots that generate timecode
• Destinations — Outputs like LTC audio, Art-Net, sACN, MTC
• Routes — Connections from one source to one destination

Each destination can only have one source. This prevents conflicts and makes your setup predictable.

🌐 Web UI

Routing Matrix

Navigate to Settings → Routing to see the routing matrix. Sources are rows, destinations are columns.

1. Find the source slot in the left column
2. Click the checkbox in the destination column
3. The route is active immediately

Quick Route from Slot

You can also route directly from a slot card:

1. Click the gear icon on a slot
2. Select Outputs tab
3. Toggle the outputs you want this slot to feed

⌨️ CLI

List Routes

bptimecode route list

Create a Route

bptimecode route create --source slot:1 --dest ltc:default

Common Destinations

Delete a Route

bptimecode route delete --dest ltc:default

🔌 HTTP API

Endpoints

List Routes

curl http://localhost:5050/api/v1/routes

Create a Route

curl -X POST http://localhost:5050/api/v1/routes \
  -H "Content-Type: application/json" \
  -d {"source": "slot:1", "destination": "ltc:default"}

📡 OSC

Addresses

# Route slot 1 to LTC
oscsend localhost 5051 /bptimecode/route ss "slot:1" "ltc:default"

# Route slot 2 to Art-Net universe 1
oscsend localhost 5051 /bptimecode/slot/2/route s "artnet:1"

# Remove LTC route
oscsend localhost 5051 /bptimecode/unroute s "ltc:default"