Troubleshooting
Short stubs for pains that already have honest docs elsewhere. Prefer the linked guided path over inventing new chrome.
Install / UI
| Symptom | What to do |
|---|
| UI won’t open | Confirm the host is running; open http://localhost:7474 (port 7474). Getting Started · 01 |
Linux install.sh missing | Expected — Linux tarball has no install.sh. Extract and run ./BPShowServer. |
| Show is empty / sparse | Fresh Community loads Default. Blue Lamp — Theater Show is not guaranteed — build in 03 or load only if a show list has it. |
Audio / cartwall
| Symptom | What to do |
|---|
| “No clips” / empty Play picker | Fresh 1.0.190 library is empty. Control → Audio → Library → Upload (modal Upload audio; mp3 / wav / zip). Import audio & play an SFX |
| Fire says no audio output device | You are not broken. Skip local hearing, or send cartwall SFX to a network audio device. Overview · network audio device · Getting Started · 04 |
| Expected preloaded Airhorn / Rimshot | Those names are Blue Lamp Theater sample aiming-for labels — not Community preload files. Upload your own (optional CDN sample-sting-a / sample-sting-b). |
| Only hear Local Pulse | Demo-box validation only. Production differentiator = network sinks (GET /api/v1/audio/sinks). |
| Looking for Cloud SFX to fill Library | Prefer Library → Upload. Generated SFX uses Control → Audio → SFX Generation after I/O → Add Endpoint → ElevenLabs — not Cloud SFX. |
Network sinks / spatial
| Symptom | What to do |
|---|
| No network audio device listed | Confirm under I/O → Devices / Integrations; check GET /api/v1/audio/sinks. Protocol mix: AES67 / ST2110 / Sonos / garden speaker / console·Q-SYS as available. I/O |
| Can’t find a System sink editor for spatial | Expected — bind with Control → Audio → Spatial Layouts → Add Speaker → Audio Output → Select output…. Getting Started · 05 |
| Looking for a spatial OSC address for the bed | Community has no dedicated spatial OSC panel — do not invent an address. Use DMX Position Control on the Spatial Zone, script, or OSC → show commands. |
| Spatial move breaks cartwall fire | Restore 04 route first. Spatial (05) is optional — do not break the cartwall → network audio path. |
Lighting
| Symptom | What to do |
|---|
| Twinkly won’t take “DMX like a fixture” | Drive Twinkly + WLED as realtime RGB(W) endpoints from the show graph. Holiday lighting I/O |
| Need Light-O-Rama (or another custom bridge) | Open AI → Plugin Builder (/plugin-builder), script the bridge, review under Automation. AI |
AI / MCP / Cloud
| Symptom | What to do |
|---|
| Looking for Cloud signup | Prefer on-prem / LAN ShowServer + MCP Server. If you already operate a Cloud-capable deployment, use that MCP endpoint. API / MCP · AI |
| Where is MCP? | AI → MCP (/mcp), title MCP Server — Enable MCP server, MCP URL, Transport, Require bearer token, Access token, Tool policy. |
| Where is Plugin Builder? | AI → Plugin Builder (/plugin-builder). |
| Where is Voice LLM? | AI → Assistant and/or I/O → Add Endpoint → Voice LLM (voice-llm); Action Deck Add button → Press → intercom / Voice LLM listen. |
| AI chrome / screenshots on Docs | Real Demo Grok stills on Getting Started · 06; do not invent extra AI UI elsewhere |
| Voice / AI on page 1 feels risky | Park them on a later Action Deck page until trusted. Control |
Still stuck?