Od nuly na plac

CueX Manager v2d „builder" · aktualizováno 2026-07-26

Princip — offline-first

Celou instalaci jde postavit na počítači, bez jediného připojeného zařízení: zóny, rozmístění, plán zařízení, show módy (i jejich mapování na konkrétní krabičky) i samotný show projekt v CueX Editu. Na place pak zbývá jediný krok navíc — zapojit hardware a spárovat ho s tím, co už je hotové. Tahle stránka je návod krok za krokem pro obě fáze (scénář A — nová instalace úplně od nuly) a krátce i pro rozšíření instalace, která už běží (scénář B).

Scénář A — nová instalace od nuly

Např. nová výstava/instalace, kde ještě nic neexistuje — ani zóny, ani hardware.

Otevři Manager dashboard, záložka Mapa → tlačítko + NOVÁ INSTALACE v toolbaru → zadej název a identifikátor (předvyplněný slug). Vznikne prázdná mapa bez zón, bez zařízení, bez plánu.

Zapni přepínač UPRAVIT u stromu zón vlevo. Dvě cesty, jak založit zónu:

• + ZÓNA ve stromu — formulář (název, volitelný rodič), zóna se umístí na první volné místo na mapě.
• KRESLIT ZÓNU (tlačítko nebo klávesa Z) — tažením na mapě nakreslíš zónu přesně tam a v té velikosti, jak chceš. Tažení přes už existující zónu založí podzónu (nejmenší zóna, do které se nakreslený obdélník celý vejde, se sama nabídne jako rodič — vidíš to živě jako tečkovaný rámeček za tahu).

Mřížka (výchozí zapnuto, klávesa Alt dočasně vypne) a zarovnávací vodítka (magnet na hrany sousedních zón) drží rozestavění úhledné bez pixelového doohýbávání. Máš víc podobných komůrek (typicky opakující se stánky/kóje)? Postav jednu vzorovou a použij Duplikovat zónu v panelu zóny — zkopíruje se i s celým plánem (viz krok 3).

Nahraj PODKLAD (půdorys, png/svg/jpg) tlačítkem v toolbaru — usnadní přesné umístění zón podle reálného prostoru. Zóny i zařízení jde kdykoliv doladit tažením (drag) nebo za roh (resize). Víc zón najednou? VÝBĚR (klávesa V nebo Shift+klik) + zarovnávací panel (zarovnat vlevo/nahoře/na střed, srovnat šířku/výšku, rozestoupit rovnoměrně). Cokoliv se pokazí — ⌘Z vrátí zpět, klávesa „?" ukáže všechny zkratky.

Zóna, ve které zatím není žádné (ani plánované) zařízení, se kreslí jako přízrak (tečkovaný rámeček, ztlumená výplň) — poznáš na první pohled, co je zatím jen návrh.

Klikni na zónu → sekce PLÁN → + PŘIDAT: typ zařízení z katalogu (PAR, projektor, Svipr HD, CueX Box, PlayX…), jméno (předvyplní se podle typu), počet (1–20 najednou, očíslované). Žádný hardware zatím nemusí existovat — každá položka je ve stavu ČEKÁ NA INSTALACI (neutrální šedá, ne červená — to není problém, jen ještě nezačalo).

Módy (pojmenované varianty provozu — „Muzikál", „Program pro školy") se dají navrhnout, i když ještě žádné zařízení neexistuje: mapování v editoru módu smíš zadat na plánovanou položku (interní planId) místo na konkrétní deviceId. Jakmile se pak na place zařízení spáruje s tou položkou (krok 8), mapování se automaticky přepíše na jeho skutečné ID — mód začne fungovat okamžitě, bez zásahu.

Panel zóny → tlačítko EXPORT PLÁNU stáhne plan-<zóna>.cuexplan. V CueX Editu: Projekt ▾ → Import plánu zóny… → vyber soubor → náhled (počet zařízení, rozpoznané typy, co se přeskočí) → Importovat. Založí se zařízení s DMX adresami přidělenými sekvenčně a výchozí šablonou podle typu přehrávače. Odsud pokračuje běžná autorská práce v Editu — timeline, cue, FX, media routing — přesně jako u instalace, kde hardware už fyzicky je. Plný postup: kapitola 32.10 v příručce.

Z hotového show projektu se stejně jako vždy připraví deploy balíček (.cuexpkg) pro každý Box/PlayX — offline krok, nezávislý na tom, jestli je hardware zapojený. Připrav si je předem, ať je na place jen nahraješ.

Na place — zapoj a spáruj

Naflashuj SD kartu (CueX Box / PlayX image), zapoj napájení a síť. Pokud image obsahuje předvyplněnou adresu Manageru, zařízení se přihlásí samo — funguje i na čisté síti bez internetu (adresa Manageru je jen běžná ws:// LAN adresa, žádné omezení na cloudflared/WSS).

Bez předvyplněného configu (nebo když se přihlašovací adresa mění) připoj krabičku na místě z jejího vlastního operátorského webu — karta Připojení k manageru (Runtime i PlayX), formulář Manager URL + párovací kód, žádné SSH ani editace souboru. Podrobně: kapitola 26.15/27.5b v příručce.

V Manageru u konkrétní naplánované položky (panel zóny → PLÁN) vygeneruj cílený párovací kód — jakmile ho zařízení při přihlášení použije, spáruje se automaticky (zóna se přiřadí, mód mapping se přepíše, viz krok 4). Kód platí po omezenou dobu (zobrazenou po vygenerování).

Bez konkrétní položky jde vygenerovat i obecný kód — zařízení se pak objeví nespárované a přiřadíš ho ručně v dalším kroku.

Tlačítko PROPOJENÍ v hlavičce dashboardu (odznak = počet nových zařízení) otevře wizard: sloupec NOVÁ ZAŘÍZENÍ (zařízení bez zóny/plánu) vedle ČEKÁ NA INSTALACI (nespárované plánované položky). Pro shodu podle typu wizard rovnou nabídne návrh — jedno kliknutí na PROPOJIT; jinak vyber ručně ze seznamu. Spletl ses? ODPOJIT ve sloupci SPÁROVANÁ ZAŘÍZENÍ vrátí zpět zařazení do zóny i propojení s plánem (i mód mapping).

Nahraj připravený .cuexpkg balíček na zařízení (stejný krok jako u jakékoliv jiné instalace — bez ohledu na to, že tahle byla navržená offline).

Panel zóny i dashboard teď ukazují Plán vs. realita: OK (spárováno a hlásí se), zbytek ČEKÁ NA INSTALACI mizí položka po položce, jak se zařízení přihlašují. Souhrn PLÁN: N/M OK · X CHYBÍ · Y NAVÍC na kartě instalace ukáže na první pohled, jestli něco chybí nebo je navíc. Nakonec aktivuj mód pultem „MÓDY" — díky kroku 4 a 9 už všechno správně mapuje na skutečná zařízení.

Scénář B — rozšíření živé instalace

Stejný postup, jen po menších krocích, zatímco zbytek instalace normálně běží (např. Peklo Čertovina + nová komůrka):

1. UPRAVIT → + ZÓNA (nebo KRESLIT ZÓNU) — nová zóna vznikne jako přízrak, čistě plánovaná, zatímco okolní zóny dál normálně provozně běží.
2. Naplánuj do ní zařízení (krok 3 výše). Provoz zbytku instalace není nijak dotčený — diff u nové zóny jen ukazuje ČEKÁ NA INSTALACI, neutrálně, ne jako chybu.
3. Až přijde hardware: enrollment → PROPOJENÍ (kroky 7–9 výše) → zóna „ožije" první telemetrií — z přízraku se stane plnohodnotná zóna se stejným zacházením jako všechny ostatní.

FAQ

Musím projít všechny kroky, nebo jde postavit i napřímo na place?

Plán i builder jsou volitelné nástroje pro případy, kdy se vyplatí připravit věci předem (víc zón, opakující se komůrky, práce na dálku). Menší nebo jednorázová instalace jde klidně stavět přímo na place bez plánu — enrollment a ruční přiřazení zóny (bez PROPOJENÍ wizardu) funguje i tak.

Co když se plán a realita neshodují?

Přehled Plán vs. realita to ukáže explicitně: CHYBÍ (červeně) znamená, že se něco už jednou spárovalo a teď se přestalo hlásit — na rozdíl od ČEKÁ NA INSTALACI, což je neutrální „ještě nezačalo". NAVÍC je zařízení, které se hlásí, ale v plánu vůbec není. Detail: sekce „Po zapojení — Plán vs. realita" v Plánování instalace.

Musí mít Manager při zapojení internet?

Ne — enrollment i párování fungují na čisté LAN bez internetu, adresa Manageru je jen běžná WebSocket adresa v místní síti.

→ Plánování instalace (koncept plánu a katalogu do detailu) · Kompletní příručka (kapitoly 32.8b–32.10 — CueX Manager)