05 · Spatial DMX / OSC / script

Keep 04 · Cartwall SFX → network audio device working, then treat those network sinks as speakers and move the bed with DMX / OSC / script. Optional — not required for first-timers.

At Blue Lamp Theater: a House walk-in or Bits bed (your uploaded Library file) is already on a network audio device; spatial motion proves the same graph can pan that bed across sinks — not a second audio app.

Before you start

Step 04 done: at least one Bits (or House) cartwall take lands on a network audio device.
Do not break that route to chase spatial. Local Pulse stays demo-box validation only.
Reference: I/O, Automation, Control, API / MCP overview.
Product truth (Community 1.0.190): spatial lives under Control → Audio → Spatial Layouts (tab id layouts). Runtime bridge id DmxSpatialBridge maps DMX → zone X / Y with realtime updates over SignalR. There is no separate Spatial top-nav item.

Steps

A · Confirm sinks-as-speakers (do not redo 04)

Under I/O → Devices / Integrations, confirm your network audio endpoints are online. You can also list them with GET /api/v1/audio/sinks.
Fire one Bits (or House walk-in) take once. Prove the network path before touching spatial controls.
Mentally treat each online sink as a speaker in the room layout — not as Local Pulse on the demo box.

B · Build the spatial layout (speakers + zone)

Open Control → Audio → Spatial Layouts (tab id layouts). This is the spatial surface — not a separate Spatial nav item.
On the canvas, click Add Speaker. In the speaker inspector set Name, X, and Y. Open the Audio Output dialog and pick your network sink from the sink picker (Select output…). Bind speakers this way — there is no separate System sink editor for spatial.
Click Add Spatial Zone. In the Spatial Zone inspector set Name (you can also drag the zone on the canvas).
In the zone inspector, open section DMX Position Control:
- Turn on Enable DMX Control
- Set Source Universe
- Set X Ch and Y Ch (each 1–512)
- Click Save DMX Config
At runtime, DmxSpatialBridge maps incoming DMX to that zone’s X / Y; clients see updates over SignalR.

C · Move once via DMX, script, or OSC→show commands

Pick one mover for the first take. Do not wire everything before you have heard a single clean move.

Path	First take	Exact chrome (1.0.190)
DMX	Drive the Spatial Zone X/Y so the bed pans across speakers bound to network sinks	Zone inspector → DMX Position Control → Enable DMX Control, Source Universe, X Ch / Y Ch (1–512), Save DMX Config. Runtime: `DmxSpatialBridge` + SignalR
Script	Own a short Automation / cue that moves the zone (or fires show commands) once	Prefer readable show logic under Automation
OSC	Fire show commands over OSC (same graph as UI) — there is no dedicated spatial OSC panel and no invented OSC address for the bed	Use OSC → show commands; do not invent a spatial OSC address

Start the bed (cartwall House walk-in or Bits bed — your uploaded Library file from 03).
Trigger the chosen mover once. Watch zone X / Y (or speaker levels) change while audio stays on the network audio device path via each speaker’s Audio Output.
Optional: bind an Action Deck tile (later page — not page 1) that runs the same move operators just heard.

D · Operator take (keep it optional)

Run the take once for operators: bed up → move → bed settle.
If anything fails, fall back to the 04 fire path. Spatial is optional; cartwall SFX → network audio device remains the solid stop.

Checks

Check	Expect
04 still works	Bits / House still land on the network audio device
Nav	Control → Audio → Spatial Layouts (`layouts`) — no Spatial top-nav
Speakers	Add Speaker → Name / X / Y → Audio Output → Select output… (network sink)
Zone + DMX	Add Spatial Zone → DMX Position Control enabled with Source Universe, X Ch / Y Ch, Save DMX Config; `DmxSpatialBridge` + SignalR at runtime
OSC	No dedicated spatial OSC panel; no invented bed OSC address — use DMX, script, or OSC → show commands

Next (optional)

06 · AI voice + Plugin Builder

Or return to Getting Started / Download.