XLAB SHOW CONTROL ECOSYSTEM · SINGLE SOURCE OF TRUTH

Vlastní show-control stack
místo cizích krabiček.

CueX Manager je program, ve kterém nahrazujeme ENTTEC S-Play vlastním CueX Runtime, playery Svipr vlastním PlayX a operátorská rozhraní stavíme v ControlX.

Kompletní dokumentace Aktuální verze ekosystému: CueX 0.9.1 · ControlX 0.1.0 Implementační plán Diagram zapojení Design krabiček + 3D prohlížeč aktualizováno 2026-07-19 (E1 hotovo)
01

Proč to děláme

motivace

Výsledek: instalace typu Peklo Čertovina kompletně z vlastních komponent — s otevřeným API, webovým ovládáním a agentním řízením přes MCP, které nemá nikdo na trhu.

S-PLAY

Bez API na obsah

Show se do S-Play dostává přes sACN record a ruční klikání dle deploy sheetu. Nahrávací roundtrip je křehký (envelope triky, prahy, žádný feedback) — obcházíme ho, ale neodstranili jsme ho.

LIMITY

16 cues · 8 playlistů

S-Play Mini nemá scheduler, návaznosti playlistů řeší jen trikem (UDP sám sobě). Peklo je na hraně limitů, další instalace narazí.

SVIPR

Černá skříňka

Playery brumí (zemní smyčka na jacku Raspberry), nemají dokumentaci, API ani stavový feedback. IP druhého kusu dodnes neznáme.

PRODUKT

Prodejný celek

Instalaci pak umíme dodat celou z vlastních komponent — otevřený formát show, web ovládání, mobilní panely a MCP agentní řízení. To žádný konkurent nenabízí.

02

Subprodukty

komponenty
Cue Edit
DESKTOP APP · MAC

Authoring studio: timeline, 2D simulátor, patch, média, deploy. Engine má v sobě — na modelování není potřeba nic dalšího. Offline s lokálním projektem, nebo „connect mode" proti Runtime (pull → uprav → push). Produktový web + příručka ↗

EXISTUJE · v0.9.1 · 3 142 testů (celé monorepo)
Cue Runtime
HEADLESS SOFTWARE · NODE

Show engine jako nasazená služba: přehrávání, triggery (OSC/UDP/DMX/GPI/RS-232/schedule), nahrávání dynamic cues, Ops API + MCP, vestavěné webové rozhraní pro operátory (vzor S-Play web — libovolný browser v síti). Běží na Boxu, nebo na počítači v roli boxu.

SW HOTOVÝ 2026-07-20 · OPS API + WEB + MCP · ČEKÁ NA HW
Cue Box
HARDWARE · PI 5 / N100

Krabička = Runtime + provisioned image + fyzické I/O: 8× opto-izolovaný vstup (tlačítka, PIR, PLC), 4× relé, USB-DMX, USB-RS232, RTC probouzení, read-only filesystém (přežije vytržení ze zásuvky).

SW HOTOVÝ · IMAGE + SELF-TEST + I/O · ČEKÁ NA HW
Play Runtime + Box
SOFTWARE + HARDWARE · PI 5 + DAC

Síťový video/audio player — náhrada Svipr HD. Drop-in kompatibilní (OSC /svipr/…), navíc čisté symetrické XLR audio (HiFiBerry DAC2 Pro XLR — konec brumu), Ops API, upload médií po síti, heartbeat, mute/gain na povel. Koncept →

SW HOTOVÝ · SVIPR DROP-IN (mpv E2E) · ČEKÁ NA HW
Control
SAMOSTATNÝ PRODUKT · IOS / ANDROID / WEB

Builder + runtime mobilních operátorských panelů (OSC/UDP). CueX Box bude v builderu target jako každý jiný (profil CUEX_RUNTIME_PROFILE); později si panel stáhne z Runtime „capabilities manifest" a složí se poloautomaticky.

MVP CORE HOTOVÝ · 76/76 TASKŮ · iOS APP FUNKČNÍ
Cue Manager (fleet vrstva)
LIVE · v1

Centrální dohled instalací: zdraví a self-testy všech Boxů a playerů, verze, vzdálené ovládání (start/stop, restart s potvrzením), alerty a hromadný deploy. Zařízení se hlásí jediným odchozím spojením přes bránu — žádná VPN, cloud nikdy není v show path. Součástí dashboard, Telegram alerty a MCP rozhraní pro agentní dohled.

AŽ ≥2 INSTALACE
03

Diagram zapojení

architektura
CueX Edit tvorba · timeline · simulátor Mac (Electron) Agent (MCP) Claude · diagnostika · editace ControlX panel iPhone / iPad · OSC Libovolný browser web rozhraní Runtimu · operátor CueX Box CueX Runtime — engine · triggery capture · Ops API · MCP · web OSC :8000 · UDP :5000 sACN · Art-Net in/out USB-DMX · USB-RS232 GPI 8× · relé 4× · RTC Ops API :9080 · MCP :9440 mDNS + heartbeat :9091 DMX rig PARy · stroba · efekty PlayX Box A video HDMI audio XLR (bez brumu) PlayX Box B video HDMI · mute Projektory / BMS PJLink · RS-232 · relé pull / push · Převzetí DMX out OSC upload médií (hash manifest) CueManager fleet dohled · alerty · deploy · MCP cloud / XLAB infra · v1 LIVE WSS · enrollment tokeny 1× odchozí WSS · gateway role · žádná VPN

Princip: Runtime vlastní dráty. Všechna fyzická zapojení vedou do Boxu. Edit při ladění na place výstupy krabičky dočasně převezme (režim PŘEVZETÍ) — nic se nepřepojuje; po doladění jedna akce „Nahrát show + vrátit provoz".

04

Model úrovní — co se dělá kde

L0–L2
L0

Uvnitř playlistu (timeline)

„Co se stane v čase t" — DMX keyframy a cues, spouštění videí na PlayX, event stopa: UDP · OSC · RS-232 („vypni projektor") · relé · PJLink · inline čekání na trigger.

TVOŘÍ SE V EDITU · SOUČÁST SHOW.JSON
L1

Show logika (nad playlisty)

„Kdy a proč se který playlist spustí a co následuje" — triggery → akce, návaznosti (po konci A spusť B / vrať ambient), skupiny zón (hraje jen jeden → crossfade), priority + HTP, scheduler (čas, dny, sunrise/sunset), pravidla nahrávání, intenzity.

TVOŘÍ SE V EDITU · VYKONÁVÁ RUNTIME · SOUČÁST SHOW.JSON
L2

Provozní řízení

Zásahy zvenku za běhu — start/stop, hlasitosti, record arm, seek, režimy, diagnostika. Přichází přes Ops API a jeho fasády: web rozhraní · ControlX · GPI tlačítka · OSC · MCP agent.

JEN RUNTIME · NENÍ V SHOW.JSON

Díky tomu je show včetně logiky přenositelná: jiný Box, stejný soubor, stejné chování.

05

Scénáře provozu

S1–S8
S1

Authoring doma

Edit + simulátor, lokální projekt. Volitelně kus hardwaru na stole.

S2

Ladění na place

Edit převezme výstupy Boxu, světla i playery reagují živě, nic se nepřepojuje. Pak atomicky „Nahrát show".

S3

Denní provoz

Tlačítko pro průvodce, ControlX pro obsluhu, web pro techniky, scheduler na otevíračku.

S4

Dynamic cue z pultu

„Nahraj do slotu 5, stop na klid" — pult nahraje look rovnou do Boxu. Bez Macu.

S5

Jednorázová akce

Notebook = Runtime + USB-DMX. Tatáž show, stejné panely.

S6

Agentní řízení

„Přidej 10 s dohasínání a ztlum B o 3 dB" — MCP, s guardem v ostrém provozu.

S7

Flotila

CueX Manager čte heartbeaty všech zařízení přes gateway, zdraví/verze/alerty na jednom místě. Zařízení zůstávají autonomní.

S8

Nová instalace

Flash image, zapojit dráty, push show + médií. Deploy sheet zůstává jen jako dokumentace.

06

Implementační plán

etapy
E1

inputs_parity

HOTOVO · 2026-07-19

Vstupní vrstva komplet: Art-Net vstup, plnohodnotné OSC s argumenty, DMX trigger „kanál ≥ práh" s edge-detekcí a hysterezí, editor triggerů v UI.

UZAVŘENO: 4/4 TASKY NA 1. KOLO · $16.79 · 2003 TESTŮ · TRIGGER EDITOR + DMX MONITOR VSTUP + /cuex/ OSC NAMESPACE
E2

record_triggers

Nahrávání 2.0: armed record (start/stop triggerem nebo DMX klidem), slot policy, slot rail v Editu, auto-import, Perfect Loop. Kriticky potřeba až s Runtimem — může se posunout za E3/E4.

4–6 TASKŮ · ~$25–35
E3

splay_parity + show logika L1

HOTOVO · 2026-07-19

Srovnávačka proti plnému auditu S-Play, návaznosti playlistů (follow rules), skupiny zón, master/playlist intensity, scheduler se sunrise/sunset, static + effect cues, inline wait-for-trigger.

UZAVŘENO: 8/8 TASKŮ · $47.28 · 2141 TESTŮ · MILNÍK SPLNĚN — SROVNÁVAČKA S DŮKAZY →
E4

runtime_headless

HOTOVO · 2026-07-20

CueX Runtime jako samostatná služba (bez Electronu): web rozhraní pro operátory, režim PŘEVZETÍ, connect mode Edit↔Runtime, runtime recording, watchdog, 24h soak test na Macu.

UZAVŘENO: 6/6 TASKŮ · $36.36 · 2298 TESTŮ · RUNTIME BĚŽÍ NAOSTRO (WEB UI + WATCHDOG KILL-TEST OK) · 24H SOAK BĚŽÍ
E5

CueX Box

Krabička: Pi 5 image (read-only overlayfs, systemd watchdog), GPIO 8 vstupů + 4 relé, USB-DMX + USB-RS232, RTC probouzení, burn-in na reálném hardwaru.

5–7 TASKŮ + HW ~€100–170 · NEKICKOFFOVAT BEZ HW NA STOLE
PX

PlayX software (playx_core)

BĚŽÍ · 924–928

Pi 5 + HiFiBerry DAC2 Pro XLR na stole: ověřit mpv seamless loop, OSC latenci, čistotu XLR. Pak teprve kickoff projektu. Mezikrok pro Peklo hned: Behringer HD400 izolátor (~€25/ks) na stávající playery.

HW ~€170 · SDÍLÍ IMAGE S E5
CX

ControlX integrace

HOTOVO · PROFIL V CONTROLX

Profil CUEX_RUNTIME_PROFILE (po ustálení OSC namespace v E1), později capabilities manifest — panel se z Runtime složí poloautomaticky.

LEVNÝ TASK + KONTRAKT V E4

Rozhodnuto 2026-07-19: cíl programu potvrzen · force-return z PŘEVZETÍ ANO (s potvrzením) · RS-232 přes USB adaptér · názvosloví potvrzeno. Celkový odhad software: ~$110–170 agent cost, 5 bundlů, žádný big-bang — Peklo mezitím jede na S-Play.

07

Konfigurace krabiček

hardware

CueX Box · show controller

ZákladRaspberry Pi 5 (4 GB) / fallback N100~€70
Napájeníoficiální 27W USB-C PD~€13
Úložištěindustrial SD + read-only overlayfs~€15
DMXUSB adaptér (ENTTEC Pro / Open DMX — driver hotový) nebo sACN/Art-Net~€60
RS-232USB-RS232 adaptér, baud konfigurovatelný~€15
I/O8× opto GPI + 4× relé, svorkovnice; status LED; servisní tlačítko~€25
HodinyRTC s baterií — plánované probouzení (otevíračka)v ceně
Celkembez šasi~€200

PlayX Box · video/audio player

ZákladRaspberry Pi 5 (4 GB) — obsah v HEVC (HW dekodér)~€70
Napájeníoficiální 27W USB-C PD~€13
AudioHiFiBerry DAC2 Pro XLR — symetrický výstup, řeší brum i kvalitu€65
Úložiště + šasiindustrial SD, kovový case (kvůli XLR)~€20
SoftwarePlayX Runtime: mpv (KMS/DRM) + OSC vrstva Svipr-kompat + Ops API + web
Lifecyclepřes den „off" = HDMI+mute; večer poweroff; ráno RTC wake
Celkemna kus~€168

Srovnání: BrightSign LS445 ~€420/ks (bez MCP, OSC jen oklikou). Detaily v konceptu PlayX → · Kde koupit: nákupní seznam → · Design krabičky — 3 varianty: 1 RACK · 2 MINIMAL ✓ VYBRÁNO · 3 HEATSINK · původní: A/B · 3D vzhled (GLB) · Technický podklad: 3D prohlížeč ↗ · náhled · vana STL (MINIMAL) · víko STL (MINIMAL) · postup tisku Prusa · zdroj (Python CAD)

Rozhraní naživo & stažení

přístup
08

Kompletní dokumentace

dokumenty
ARCHITEKTURA CueX Manager — architektura ekosystému Názvosloví · principy · model úrovní L0/L1/L2 · komponenty · režimy Runtime · scénáře S1–S8 · porty a protokoly PLÁN CueX → plná náhrada S-Play: plán upgradu Etapy E1–E5 · architektura nahrávání · co už stojí (audit kódu) · odhady KONCEPT PlayX — náhrada Honza playeru (Svipr HD) Diagnóza brumu · 3 cesty (izolátor / BrightSign / vlastní) · HW + SW návrh · napájení a lifecycle RESEARCH S-Play feature audit Kompletní schopnosti S-Play 70092 + Mini 70093 z oficiálních manuálů · srovnání s Pharos/PixiLab · vstup pro srovnávačku E3 MILNÍK Srovnávačka CueX vs S-Play Parita doložená per feature (✅ s důkazem) · vědomá vynechání · 9 oblastí nad rámec S-Play · validátor limitů PLÁN „Zapojím a funguje" — dostavba bez fyzického testování QEMU/Docker emulace · self-test krabiček · fallbacky · 5 bundlů · SW KOMPLET 2026-07-20 — čeká se na hardware RUNBOOK Runbook — Den zapojení Krok za krokem: build image → flash SD → dráty → první zapnutí (LED kódy) → akceptační test jedním příkazem · S-Play fallback · údržba na dálku NÁKUP Nákupní seznam hardware Ověřené obchody, ceny a dostupnost (RPishop, HiFiBerry, Thomann…) · balíčky: izolátory hned / PlayX PoC / Box prototyp · ~8–8,5 tis. Kč LEGACY Svipr HD — protokolová specifikace OSC :7000 a UDP :10000 povely stávajících Honza playerů (kompatibilní vrstva PlayX)

Zdrojová pravda dokumentů žije v repu (peklo-sim/docs/, controlx/docs/); tento web se aktualizuje spolu s nimi při každé změně programu.