Tutorials & handleidingen

Besturingssysteem: Windows 10 of 11 (64-bit)
Processor: Intel i5 / AMD Ryzen 5 of beter (quad-core aanbevolen)
RAM: 8 GB minimaal, 16 GB aanbevolen voor grote shows
Schijf: 500 MB vrije ruimte voor installatie, SSD aanbevolen
Beeldscherm: 1920×1080 minimaal
Netwerk: Ethernet aanbevolen voor Art-Net, sACN en Remote
Audio: Elke ASIO- of WDM-audio-interface voor LTC
USB: Voor Explo TX2-70K (RS232/USB-adapter)

OnCue Timecode is een native Windows desktopapplicatie — geen cloud, geen browser, geen internetverbinding nodig om je show te draaien.

1. Download het installatieprogramma van de Download-pagina of je accountportaal.
2. Voer het .exe-installatieprogramma uit als Administrator.
3. Volg de installatiewizard — kies je installatiemap (standaard: C:\Program Files\OnCue Timecode).
4. Start OnCue Timecode vanuit het Start-menu of de snelkoppeling op het bureaublad.
5. Ga naar Instellingen → Licentie en voer je licentiecode in (ontvangen per e-mail na aankoop).
6. Klik op 'Activeren' — OnCue verifieert je licentie online (eenmalig).
7. Je bent klaar! De app draait volledig offline na activering.

Tip: Bewaar je licentiecode goed. Je kunt deactiveren en opnieuw activeren op een andere machine via je accountportaal.

1. Maak een nieuwe show: Bestand → Nieuwe Show. Geef het een naam en stel de framerate in (25fps voor PAL, 30fps voor NTSC).
2. Voeg cues toe: Klik op '+' in de cue-lijst of druk Ctrl+N. Stel de timecode, naam en actie in voor elke cue.
3. Kies je timecode-bron: Instellingen → Timecode. Selecteer 'Intern' om OnCue als master te gebruiken, of 'LTC Input' om externe timecode te volgen.
4. Test: Druk op Play (Spatie) om door je cues te lopen. De tijdlijn toont je voortgang in real-time.
5. Arm de show: Klik op de Arm-knop als je klaar bent voor de live run.
6. Go live: Druk op Go (Enter) of laat timecode je cues automatisch triggeren.

Sla regelmatig op met Ctrl+S. OnCue slaat ook automatisch elke 60 seconden op.

De OnCue-interface heeft vier hoofdgebieden:

• Werkbalk (boven): Transportbesturing (Play, Stop, Go, Arm), timecode-display en snelle instellingen.
• Cue-lijst (midden): De cue-lijst van je show met kolommen voor timecode, naam, actie, zone, status en notities.
• Tijdlijn (onder): Visuele weergave van je cues op een tijdas. Sleep om te verplaatsen, scroll om te zoomen.
• Zijbalk (rechts): Eigenschappenpaneel voor de geselecteerde cue, output-monitors en health-dashboard.

Sneltoetsen:
- Spatie: Play/Pause
- Enter: Go (volgende cue afvuren)
- Escape: Stop
- F12: Noodstop
- Ctrl+N: Nieuwe cue
- Ctrl+S: Opslaan
- Tab: Volgende cue
- Shift+Tab: Vorige cue

Je OnCue-licentie is gekoppeld aan één machine tegelijk. Je kunt vrij deactiveren en opnieuw activeren.

Activeren: Instellingen → Licentie → Code invoeren → Activeren
Deactiveren: Instellingen → Licentie → Deactiveren (maakt de plek vrij)
Verplaatsen: Deactiveer op de oude machine, activeer daarna op de nieuwe.

Je kunt je licentie ook beheren via het online accountportaal: bekijk je abonnement, wijzig betaalmethode of download facturen.

Als je geen toegang meer hebt tot de oude machine, neem contact op met support — wij kunnen op afstand deactiveren.

OnCue controleert automatisch op updates wanneer je verbonden bent met internet. Je ziet een melding in de werkbalk.

1. Klik op de update-melding of ga naar Help → Controleer op Updates.
2. Download het nieuwe installatieprogramma.
3. Sluit OnCue Timecode.
4. Voer het installatieprogramma uit — het upgradet zonder je shows of instellingen te verwijderen.
5. Start OnCue opnieuw op.

Je shows, templates en instellingen worden opgeslagen in je gebruikersprofiel-map en worden nooit verwijderd tijdens updates. We raden aan een back-up te maken voor grote versie-upgrades.

LTC (Linear Time Code) is het meest gebruikte timecode-formaat bij live evenementen.

1. Sluit een LTC-bron aan op de lijningang van je audio-interface.
2. In OnCue: Instellingen → Timecode → Bron → LTC Input.
3. Selecteer je audio-apparaat (ASIO aanbevolen voor laagste latency, WDM ook ondersteund).
4. Kies het ingangskanaal (links of rechts).
5. Stel de framerate in zodat deze overeenkomt met je bron (24, 25, 29.97, 30 fps).
6. Het timecode-display toont inkomende TC in real-time.

Probleemoplossing:
- Geen signaal? Controleer kabelverbindingen en gain van de audio-interface.
- Onderbrekingen? Gebruik ASIO-driver met buffer ≤ 256 samples.
- Verkeerde tijd? Controleer of framerate overeenkomt met de bron.
- Aanbevolen interfaces: RME (laagste latency), Focusrite, Behringer.

OnCue kan timecode genereren voor je hele productie:

LTC-output:
1. Instellingen → Timecode → Output → LTC.
2. Selecteer je audio-outputapparaat en kanaal.
3. OnCue stuurt SMPTE-audio uit op dat kanaal.

MIDI MTC-output:
1. Instellingen → Timecode → Output → MIDI MTC.
2. Selecteer je MIDI-outputpoort.
3. MTC wordt continu verzonden terwijl het transport draait.

Art-Net timecode:
1. Instellingen → Timecode → Output → Art-Net.
2. Stel het doel-IP of broadcastadres in.
3. Art-Net timecode-pakketten worden via Ethernet verzonden.

Je kunt meerdere formaten tegelijk uitsturen — bijv. LTC voor het audioteam en Art-Net voor het lichtpult.

Voor grote shows met meerdere operators of back-upmachines:

Master-machine:
1. Instellingen → Sync → Modus → Master.
2. Stel de sync-poort in (standaard: 7000).
3. De master broadcast timecode en cue-status over het netwerk.

Slave-machine(s):
1. Instellingen → Sync → Modus → Slave.
2. Voer het IP-adres en de poort van de master in.
3. De slave volgt de timecode van de master frame-accuraat.

De slave toont een sync-status indicator (groen = vergrendeld, geel = aan het synchroniseren, rood = verloren).
Als de master ontkoppelt, kan de slave autonoom doorgaan tot herverbinding.

Best practice: Gebruik een dedicated Ethernet-switch voor sync-verkeer, gescheiden van Art-Net/sACN.

OnCue ondersteunt alle standaard SMPTE framerates:

• 24 fps — Film en cinema
• 25 fps — PAL/Europese broadcast (meest gebruikelijk bij EU live evenementen)
• 29.97 fps (drop-frame) — NTSC broadcast
• 29.97 fps (non-drop) — NTSC productie
• 30 fps — Gebruikelijk bij US live evenementen

Kies de framerate die past bij je productiepijplijn. Voor Europese live evenementen is 25 fps standaard. Voor US evenementen is 30 fps het meest gebruikelijk.

Belangrijk: Alle apparaten in je keten moeten dezelfde framerate gebruiken. Niet-overeenkomende rates veroorzaken drift en sync-problemen.

Drift en jitter kunnen optreden bij slechte klokbronnen of lange kabelafstanden.

Drift (timecode loopt langzaam uit sync):
- Controleer of alle apparaten dezelfde framerate delen.
- Gebruik één master-klok voor de hele productie.
- Voor LTC: gebruik een hoogwaardige audio-interface met stabiele klok.
- OnCue's driftcompensatie kan tot ±2 frames corrigeren.

Jitter (timecode springt onregelmatig):
- Verklein de audio-buffer (ASIO: 128-256 samples).
- Vermijd USB-hubs voor audio-interfaces — sluit direct aan.
- Scherm LTC-kabels af van DMX- en voedingskabels.
- Controleer audio-inputniveaus — te laag veroorzaakt leesfouten.

OnCue logt alle timecode-afwijkingen in het health-dashboard voor post-show analyse.

De cue-lijst is het hart van je show.

Cues toevoegen:
- Klik op '+' of Ctrl+N om een cue toe te voegen.
- Stel in: timecode (wanneer), naam (wat), actie (welke output/apparaat).
- Acties omvatten: pyro-zone afvuren, OSC verzenden, DMX sturen, MIDI triggeren, webhook, etc.

Bewerken:
- Dubbelklik op elk veld om ter plekke te bewerken.
- Sleep rijen om te herordenen (of gebruik Alt+↑/↓).
- Rechtermuisklik voor contextmenu (dupliceren, verwijderen, groeperen, taggen).

Tags & filteren:
- Wijs kleurtags toe om cues te categoriseren (pyro, licht, audio, video).
- Filter de lijst op tag om je te focussen op specifieke afdelingen.

Templates:
- Sla een cue-lijst op als template voor hergebruik bij andere shows.
- Templates bewaren alle instellingen behalve show-specifieke timecodes.

De tijdlijn geeft je een visueel overzicht van je hele show.

- Horizontale as: timecode (scrollbaar en zoombaar).
- Cues verschijnen als blokken op de tijdlijn, kleurgecodeerd op tag.
- Sleep cues naar links/rechts om hun timecode te wijzigen.
- Sleep de randen om duur in te stellen (voor aanhoudende acties zoals DMX-fades).
- Scrollwiel om in/uit te zoomen.
- Houd Shift ingedrukt en sleep om meerdere cues te selecteren.
- De afspeelkop toont de huidige positie tijdens afspelen.

Tijdlijn-banen:
- Elk outputtype krijgt zijn eigen baan (pyro, DMX, OSC, etc.).
- Klap banen in/uit om complexe shows te beheren.
- Overlapdetectie waarschuwt je bij timing-conflicten.

Quick Launch laat je cues buiten volgorde afvuren:

1. Druk op Q om Quick Launch te openen.
2. Typ het cuenummer of de naam.
3. Druk op Enter om direct af te vuren.

Standaard sneltoetsen:
- Spatie: Play/Pause transport
- Enter: Go (volgende gearmd cue afvuren)
- Escape: Stop transport
- F12: Noodstop (alle outputs)
- Ctrl+G: Ga naar timecode
- 1-9: Cue afvuren op nummer
- Ctrl+1-9: Cue armen/ontwapenen

Pas sneltoetsen aan in Instellingen → Snelkoppelingen. Je kunt ook externe MIDI-noten of Stream Deck-knoppen toewijzen aan elke actie.

Importeren:
- Bestand → Importeren → Selecteer CSV-, XML- of JSON-bestand.
- OnCue mapt kolommen automatisch (timecode, naam, actie, notities).
- Voorbeeld bekijken en mapping aanpassen voor import.
- Ondersteunt cue-lijsten van andere show-control software.

Exporteren:
- Bestand → Exporteren → Kies formaat (CSV, XML, JSON, PDF).
- CSV is compatibel met Excel en Google Sheets.
- PDF-export maakt een printklaar cue-sheet.

Rentman-integratie:
- Importeer materiaal- en crewlijsten rechtstreeks vanuit Rentman.
- Zie het Integraties-gedeelte voor setup-details.

Cue-groepen laten je gerelateerde cues als eenheid beheren:

- Selecteer meerdere cues → Rechtermuisklik → Groeperen.
- Groepen kunnen samen gearmd/ontwapend, verplaatst en gedupliceerd worden.
- Klap een groep in om het als enkele rij te zien.

Sequenties:
- Een sequentie is een groep die automatisch op volgorde afvuurt.
- Stel vertragingen in tussen cues binnen de sequentie.
- Trigger de sequentie met één Go-commando.
- Handig voor complexe pyro-effecten die precieze inter-cue timing nodig hebben.

De Explo TX2-70K is een professioneel pyrotechnisch ontstekingssysteem.

Aansluiting:
1. Verbind de TX2-70K met je PC via RS232/USB-adapter.
2. Installeer de USB-naar-serieel driver (meegeleverd met OnCue of van de fabrikant van de adapter).
3. In OnCue: Instellingen → Pyro → Apparaat → Explo TX2-70K.
4. Selecteer de COM-poort (meestal COM3-COM9).
5. Klik op 'Verbinden'. De statusindicator wordt groen bij verbinding.

Veiligheidscheckprocedure:
1. OnCue voert een continuititscheck uit op alle aangesloten zones.
2. Groen = circuit OK, Rood = open circuit of kortsluiting.
3. Bekijk alle zone-statussen voor het armen.
4. Arm het systeem alleen wanneer alle veiligheidschecks slagen.

Belangrijk: Voer altijd een visuele veiligheidsinspectie uit van het vuurgebied voor het armen. OnCue is een hulpmiddel — de operator is uiteindelijk verantwoordelijk voor de veiligheid.

Zones organiseren je pyrotechnische effecten op fysieke locatie of vuurgroep.

Zones aanmaken:
1. Instellingen → Pyro → Zones → Zone Toevoegen.
2. Geef de zone een naam (bijv. 'Podium Links', 'Finale Rek 1').
3. Wijs de TX2-70K outputkanalen toe aan de zone.
4. Stel de NEM-limiet per zone in (op basis van veiligheidsafstandberekeningen).

Producten toewijzen:
- Elke zone kan meerdere producten bevatten uit de productdatabase.
- OnCue berekent totale NEM per zone en waarschuwt als limieten worden overschreden.
- Producten bevatten artikelnummer, NEM-waarde, categorie en veiligheidsafstand.

Zone-status tijdens show:
- Armed (klaar om te vuren)
- Fired (alle producten ontstoken)
- Partial (sommige producten gevuurd)
- Error (continuiteitsprobleem)

OnCue bevat een ingebouwde productdatabase voor pyrotechniek.

Voor elk product kun je opslaan:
- Artikelnummer en naam
- Fabrikant
- NEM (Netto Explosieve Massa) in grammen
- Categorie (F1, F2, F3, F4, T1, T2)
- Veiligheidsafstand (m)
- Effecttype (mine, komeet, cake, enkele schot, etc.)
- Duur en kaliber
- Eigen notities

Importeren/exporteren:
- Importeer producten vanuit CSV of Excel.
- Exporteer je bibliotheek om te delen met teamleden.
- Producten kunnen aan zones worden toegewezen in de cue-lijst.

De database blijft bestaan tussen shows — bouw het één keer, gebruik het overal.

De noodstop (E-Stop) stopt onmiddellijk alle pyrotechnische ontsteking.

Triggermethoden:
1. Toetsenbord: Druk op F12 (standaard sneltoets).
2. OnCue Remote: Tik op de E-Stop knop (beschikbaar voor Operator- en E-Stop-rollen).
3. Hardware: Fysieke E-Stop knop op de TX2-70K.
4. Stream Deck / Companion: Dedicated E-Stop knop.

Wat er gebeurt:
- Alle vuurcommando's stoppen onmiddellijk.
- De TX2-70K ontwapent alle zones.
- De cue-lijst pauzeert (transport stopt).
- Een rode E-STOP banner verschijnt over de interface.
- Het event wordt gelogd met tijdstempel.

Herstel:
- Wis de E-Stop in de app (vereist bevestiging).
- Voer opnieuw veiligheidschecks uit voor het herarmen.
- Het vuurlog bewaart welke cues zijn afgevuurd en welke niet.

OnCue genereert automatisch NEM-rapporten voor je shows.

Rapportinhoud:
- Totale NEM per zone en voor de hele show
- Productlijst met NEM-waarden en categorieën
- Veiligheidsafstanden per zone
- Vuurlog (wat is gevuurd, wanneer, door wie)
- Continuiteitscheckresultaten

Exportformaten:
- PDF (printklaar, professionele opmaak)
- CSV (voor spreadsheets en verdere analyse)

Gebruik deze rapporten voor:
- Verzekeringsdocumentatie
- Vergunningen lokale overheid
- Post-show debrief
- Naleving regelgeving (EU pyrotechniekrichtlijn)

Het rapport wordt automatisch gegenereerd na elke show en kan ook op elk moment handmatig worden aangemaakt.

OnCue logt elk vuurgebeurtenis met nauwkeurig detail:

- Timecode waarop de cue is afgevuurd
- Zone en kanaal
- Productnaam en NEM
- Operator die de cue triggerde (of 'auto' voor getimecodet)
- Vurmethode (timecode, handmatig Go, Quick Launch, Remote)
- Eventuele fouten of misfires

Het vuurlog wordt automatisch opgeslagen met je showbestand en opgenomen in het post-show rapport. Het kan niet worden bewerkt of verwijderd — dit garandeert een manipulatiebestendig record voor verzekering en compliance.

OnCue Remote laat je je show bedienen en monitoren vanaf elke telefoon, tablet of laptop.

1. In OnCue: Instellingen → Remote → Server Inschakelen.
2. Stel een poort in (standaard: 8080) en kies je netwerkinterface.
3. OnCue toont een QR-code op het scherm.
4. Op je telefoon: scan de QR-code met je camera.
5. De Remote opent in je browser — geen app nodig.

Vereisten:
- Beide apparaten moeten op hetzelfde netwerk zitten (WiFi of Ethernet).
- Een dedicated WiFi-toegangspunt wordt aanbevolen voor betrouwbaarheid.
- De server kan tot 10 gelijktijdige verbindingen verwerken.

Tip: Gebruik voor buitenevenementen een draagbare WiFi-router met sterk signaal.

OnCue Remote ondersteunt rolgebaseerde toegangscontrole:

Operator:
- Volledige controle: Go, Stop, Pause, Arm, Disarm, E-Stop.
- Kan elke cue zien en afvuren.
- Vereist een 4-cijferige PIN.

Viewer:
- Alleen lezen: ziet live timecode, cue-lijst en status.
- Kan geen acties triggeren.
- Vereist een aparte PIN (of geen PIN voor open toegang).

E-Stop:
- Kan alleen live timecode en de E-Stop knop zien.
- Ontworpen voor veiligheidspersoneel dat noodtoegang nodig heeft.
- Vereist een eigen PIN.

Stel PINs in bij Instellingen → Remote → Rollen. Wijzig PINs voor elke show als beveiligingsbest practice.

Het Remote-display toont:

- Groot timecode-uitlezing (real-time, < 20ms latency op LAN)
- Huidige cue-naam en status
- Preview volgende cue (naam, timecode, aftelling)
- Transportstatus (afspelend, gestopt, gearmd)
- Zone-status (voor pyro-shows)
- Health-indicatoren (sync, verbindingen, fouten)

Het display past zich automatisch aan je schermgrootte aan. Op tablets krijg je een gedetailleerder weergave met de cue-lijst zichtbaar.

Dark mode is standaard (geoptimaliseerd voor backstage-gebruik). Een hoog-contrast modus is beschikbaar voor heldere omgevingen.

Art-Net laat je DMX-data versturen over je Ethernet-netwerk.

1. Instellingen → Outputs → Toevoegen → Art-Net.
2. Stel het doel-IP in (unicast) of gebruik broadcast (2.255.255.255).
3. Kies het Art-Net universe (0-32767).
4. Stel de updatesnelheid in (standaard: 40 Hz, max 44 Hz).

In je cues:
- Wijs Art-Net acties toe om kanaalwaarden in te stellen.
- Ondersteuning voor fades: stel startwaarde, eindwaarde en duur in.
- Snap-acties voor directe wijzigingen.

Werkt met elk Art-Net node: Enttec ODE, ChamSys, ETC, ADJ, Luminex, etc.

Tip: Gebruik unicast voor betrouwbare levering; broadcast voor snel testen.

sACN (Streaming ACN, ANSI E1.31) is de moderne standaard voor professioneel licht:

1. Instellingen → Outputs → Toevoegen → sACN.
2. Kies multicast (standaard, voegt automatisch de juiste multicast-groep toe) of unicast.
3. Stel het universe in (1-63999).
4. Stel prioriteit in (standaard: 100; hogere prioriteit wint bij meerdere bronnen).

Voordelen ten opzichte van Art-Net:
- Ingebouwd prioriteitssysteem voor bron-overname.
- Multicast vermindert netwerkverkeer.
- Geen 4-universe-per-subnet limiet.

OnCue stuurt tot 16 sACN-universes tegelijkertijd uit.

OSC is het meest flexibele protocol voor inter-app communicatie.

OSC verzenden vanuit OnCue:
1. Instellingen → Outputs → Toevoegen → OSC.
2. Stel het doel-IP en de poort in.
3. Stel in je cue-actie het OSC-adres in (bijv. /cue/1/go) en argumenten.

OSC ontvangen in OnCue:
1. Instellingen → Inputs → OSC → Inschakelen.
2. Stel de luisterpoort in (standaard: 8000).
3. Map inkomende OSC-adressen naar OnCue-acties (Go, Stop, cue afvuren, etc.).

Verelgebruikte integraties:
- QLab: /cue/{nummer}/go, /cue/{nummer}/stop
- Resolume: /composition/link/values, /layer/1/clip/1/connect
- TouchDesigner: custom adressen
- Ableton Live: via OSC-plugin

OnCue ondersteunt alle standaard MIDI-protocollen:

MIDI-noten:
- Stuur note-on/off om externe apparatuur te triggeren.
- Ontvang noten om OnCue-cues te triggeren.
- Map elke noot/kanaal combinatie.

MIDI MTC:
- Stuur MIDI Time Code (zie Timecode-sectie).
- Ontvang MTC voor externe sync.

MIDI Show Control (MSC):
- Stuur MSC-commando's: Go, Stop, Resume, All Off, etc.
- Target specifieke apparaten op device ID.
- Ontvang MSC-commando's van externe controllers.

Setup: Instellingen → MIDI → Selecteer je MIDI-poort(en). OnCue detecteert alle aangesloten USB MIDI-interfaces automatisch.

Het WebSocket-protocol maakt real-time tweerichtingscommunicatie mogelijk.

1. Instellingen → API → WebSocket → Inschakelen.
2. Stel de poort in (standaard: 9000).
3. Verbind vanuit elke WebSocket-client (browser, Node.js, Python, etc.).

Berichtformaat: JSON

Inkomende commando's:
- {"action": "go"} — volgende cue afvuren
- {"action": "stop"} — transport stoppen
- {"action": "fire", "cue": 5} — specifieke cue afvuren
- {"action": "estop"} — noodstop

Uitgaande events:
- Timecode-updates (configureerbare snelheid)
- Cue afgevuurd / cue voltooid events
- Transportstatus-wijzigingen
- Fout- en waarschuwings-events

Gebruik dit om custom bedieningspanelen, dashboards of integraties te bouwen met elke programmeertaal.

MQTT verbindt OnCue met IoT-platformen en smart devices.

1. Instellingen → Outputs → Toevoegen → MQTT.
2. Stel broker-adres, poort, gebruikersnaam/wachtwoord in.
3. Configureer topics voor publiceren en abonneren.

Publiceren (OnCue → apparaten):
- Topic: oncue/cue/fired — payload: cue-data als JSON
- Topic: oncue/transport/state — payload: playing/stopped
- Topic: oncue/timecode — payload: huidige TC

Abonneren (apparaten → OnCue):
- Topic: oncue/command/go — trigger Go
- Topic: oncue/command/fire/{n} — cue n afvuren

Toepassingen: hazers triggeren, LED-strips activeren, gemotoriseerde decorbeweging, integratie met domotica (Home Assistant, etc.).

Webhooks sturen HTTP-verzoeken wanneer events optreden in OnCue.

1. Instellingen → Outputs → Toevoegen → Webhook.
2. Stel de URL, methode (POST/GET) en headers in.
3. Kies welke events de webhook triggeren (cue afgevuurd, show gestart, E-Stop, etc.).

Payload: JSON met eventtype, timecode, cue-data en tijdstempel.

Integratie-voorbeelden:
- Zapier: trigger automatiseringen vanuit OnCue-events.
- Make (Integromat): complexe workflows met meerdere stappen.
- n8n: zelf-gehoste automatisering.
- Slack/Teams: showstatus-updates posten naar een kanaal.
- Custom API: trigger elk web-endpoint.

Webhooks zijn fire-and-forget — ze blokkeren de show niet als het endpoint traag is of niet beschikbaar.

Bitfocus Companion verbindt OnCue met fysieke knoppenpanelen.

Setup:
1. Installeer Bitfocus Companion op dezelfde machine of netwerk.
2. In Companion: Verbinding toevoegen → OnCue Timecode.
3. Voer het IP-adres van OnCue en de WebSocket-poort in.
4. Companion verbindt automatisch.

Beschikbare acties:
- Go, Stop, Pause, Resume
- Specifieke cue afvuren op nummer
- Arm/Disarm
- Noodstop
- Volgende cue / Vorige cue

Feedback:
- Huidige cue-naam en nummer
- Timecode-display
- Transportstatus (afspelend/gestopt/gearmd)
- E-Stop status

Werkt met Elgato Stream Deck (alle modellen), X-Keys en elk ander Companion-ondersteund apparaat.

Verbind OnCue met je Rentman-account voor naadloos projectbeheer.

1. Instellingen → Integraties → Rentman → Verbinden.
2. Autoriseer OnCue met je Rentman API-sleutel.
3. Selecteer een project om te importeren.

Geïmporteerde gegevens:
- Materiaallijst met aantallen en serienummers.
- Crew-toewijzingen en contactgegevens.
- Projectdata en locatie-informatie.
- Custom velden (gemapt naar OnCue cue-notities).

Dit helpt je shows sneller voor te bereiden — materiaallijsten worden je startende cue-lijst, en crew-info is beschikbaar in het showbestand ter referentie.

Opmerking: Rentman-integratie vereist een actief Rentman-account met API-toegang.

QLab en OnCue communiceren via OSC.

OnCue → QLab:
1. Voeg een OSC-output toe die wijst naar het IP en de poort van QLab (standaard 53000).
2. In je cue-actie: OSC-adres /cue/{nummer}/go, /cue/{nummer}/stop, etc.
3. OnCue triggert QLab-cues op de juiste timecode.

QLab → OnCue:
1. In QLab: stuur OSC naar het IP en de poort van OnCue.
2. Gebruik /oncue/go, /oncue/fire/{n}, etc.
3. QLab kan OnCue-acties triggeren.

Veelvoorkomende setup: OnCue als master timecode, die tegelijk QLab (voor audio/video) en pyro triggert.

Na elke show genereert OnCue een gedetailleerd showrapport.

Inhoud:
- Shownaam, datum, locatie en crew
- Totale runtime en cue-aantal
- Elk event in chronologische volgorde (cues afgevuurd, fouten, E-Stops)
- Timecode-nauwkeurigheidsanalyse (drift, jitter, onderbrekingen)
- Pyro-rapport: NEM-totalen, vuurlog, zone-status
- Integratie-events: OSC, Art-Net, MIDI berichten verzonden

Exporteer als PDF voor archivering of deel met je productieteam.

Het rapport wordt automatisch gegenereerd wanneer je de show stopt. Je kunt het ook op elk moment handmatig genereren via Bestand → Exporteren → Showrapport.

Het health-dashboard toont live systeemstatus:

- Timecode: signaalkwaliteit, framerate, drift
- Netwerk: Art-Net/sACN nodes verbonden, latency
- MIDI: poorten actief, berichtentelling
- Pyro: TX2-70K verbinding, zone-continutiteit
- Remote: verbonden clients, latency
- CPU- en geheugengebruik

Kleurindicatoren:
🟢 Groen = gezond
🟡 Geel = waarschuwing (onderzoek nodig)
🔴 Rood = fout (actie vereist)

Alle health-data wordt gelogd en opgenomen in het post-show rapport.

OnCue kan showrapporten automatisch e-mailen na elke voorstelling.

1. Instellingen → Rapporten → E-mail → Inschakelen.
2. Configureer SMTP-instellingen (server, poort, inloggegevens).
3. Voeg ontvanger e-mailadressen toe.
4. Kies wat je wilt opnemen: volledig rapport, alleen samenvatting, of PDF-bijlage.

De e-mail wordt automatisch verzonden wanneer je de show beëindigt. Handig om remote stakeholders, productiemanagers en verzekeringscontacten op de hoogte te houden.

Post-show analysetools helpen je toekomstige uitvoeringen te verbeteren.

Heatmaps:
- Visuele tijdlijn die cue-dichtheid en timing toont.
- Rode zones geven momenten met hoge activiteit aan.
- Helpt bij het identificeren van potentiële knelpunten of overbelaste secties.

Statistieken:
- Gemiddelde cue-naar-cue timing
- Cue-nauwkeurigheid (hoe dicht bij doel-timecode)
- Reactietijden (handmatige triggers)
- Foutpercentage per zone/output

Vergelijk tussen shows om verbetering in de tijd bij te houden. Exporteer grafieken als afbeeldingen voor presentaties of debriefs.

Een goed ontworpen netwerk is cruciaal voor betrouwbare show-controle.

Aanbevelingen:
- Gebruik gigabit Ethernet-switches (geen WiFi) voor Art-Net, sACN en sync.
- Scheid verkeer: dedicated VLAN of switch voor show-controle vs. internet.
- Gebruik statische IP-adressen voor alle show-kritische apparaten.
- Schakel slaapstand/sluimerstand uit op de OnCue-PC.
- Schakel Windows Firewall uit voor de show-control netwerkinterface (of voeg regels toe).

WiFi (voor OnCue Remote):
- Gebruik een dedicated toegangspunt (niet de WiFi van de locatie).
- 5 GHz-band voor lagere latency.
- Positioneer de AP met zichtlijn naar operators.

Test het hele netwerk voor elke show — OnCue's health-dashboard toont netwerkstatus.

Voor kritische shows is redundantie essentieel.

Showbestand back-up:
- OnCue slaat automatisch elke 60 seconden op.
- Bewaar kopieën op USB-stick en cloudopslag.
- Versiebeheer je showbestanden (show_v1.ocue, show_v2.ocue).

Machine-redundantie:
- Stel een slave-machine in met hetzelfde showbestand.
- De slave volgt de master en kan overnemen als de master uitvalt.
- Oefen de overschakelprocedure voor de show.

Netwerk-redundantie:
- Gebruik managed switches met link-aggregatie.
- Neem een reserve-switch en kabels mee.
- Heb een back-up WiFi AP voor Remote.

Optimaliseer je Windows-PC voor betrouwbare show-controle:

1. Energieplan: Stel in op 'Hoge Prestaties' (niet Gebalanceerd).
2. Schakel slaapstand, sluimerstand en scherm-timeout uit.
3. Schakel automatische Windows Updates uit tijdens shows.
4. Sluit onnodige achtergrondapps (Outlook, Teams, browsers).
5. Stel je audio-interface in op exclusieve modus in Windows Geluidsinstellingen.
6. Schakel USB selectieve onderbreking uit in Energiebeheer.
7. Voor ASIO: stel buffer in op 128-256 samples.
8. Schakel WiFi uit op de show-control NIC (gebruik alleen Ethernet).
9. Voer OnCue uit als Administrator voor beste prestaties.
10. Houd 20%+ vrije schijfruimte op de systeemschijf.

OnCue monitort CPU en geheugen in het health-dashboard — mik op < 50% CPU tijdens shows.

De WebSocket API laat je custom interfaces bouwen.

Verbind met: ws://{oncue-ip}:{poort}
Authenticatie: Stuur {"auth": "je-api-sleutel"} na het verbinden.

Events die je ontvangt:
- timecode: {"type": "tc", "tc": "01:23:45:12", "fps": 25}
- cue_fired: {"type": "cue", "id": 5, "name": "Pyro Zone 1", "tc": "..."}
- transport: {"type": "transport", "state": "playing"}
- estop: {"type": "estop", "active": true}

Commando's die je kunt sturen:
- {"action": "go"}
- {"action": "stop"}
- {"action": "fire", "cue": 5}
- {"action": "arm", "zone": 1}

Bouw met HTML/CSS/JS, React, Python, Node.js, of elke taal met WebSocket-ondersteuning.

Als OnCue geen inkomende timecode toont:

1. Controleer fysieke verbindingen — zit de LTC-kabel goed aangesloten?
2. Controleer niveaus audio-interface — is er signaal op de ingang? Gebruik de meter van je audio-interface.
3. Verifieer dat de juiste ingang is geselecteerd in Instellingen → Timecode.
4. Controleer de framerate-instelling — deze moet overeenkomen met de bron.
5. Probeer een ander audio-ingangskanaal (links/rechts).
6. Herstart de audio-interface en OnCue.
7. Test met een andere LTC-bron of kabel.
8. Controleer Windows Geluidsinstellingen — zorg dat de interface niet gedempt of uitgeschakeld is.

Bij gebruik van MIDI MTC: verifieer dat de MIDI-poort is geselecteerd en niet in gebruik is door een andere applicatie.

Als je Art-Net of sACN-apparaten niet reageren:

1. Verifieer netwerkverbinding — kun je het apparaat pingen?
2. Controleer IP-adressen — beide apparaten moeten in hetzelfde subnet zitten.
Art-Net standaardbereik: 2.x.x.x of 10.x.x.x
sACN: elk subnet (multicast regelt de routing).
3. Controleer of Windows Firewall OnCue toestaat op het netwerk.
4. Verifieer dat het universe-nummer aan beide kanten overeenkomt.
5. Controleer of de output is ingeschakeld en actief in OnCue's outputlijst.
6. Probeer broadcast/multicast in plaats van unicast (of andersom).
7. Gebruik Wireshark om te verifiëren dat pakketten worden verzonden.

Veelvoorkomend probleem: Windows wijst een 169.254.x.x adres toe wanneer DHCP faalt — stel in plaats daarvan een statisch IP in.

Als OnCue geen verbinding kan maken met de TX2-70K:

1. Controleer de USB/RS232-kabelverbinding.
2. Verifieer de COM-poort in Windows Apparaatbeheer.
3. Zorg dat geen andere software de COM-poort gebruikt.
4. Probeer een andere USB-poort (vermijd hubs).
5. Herinstalleer de USB-naar-serieel driver.
6. Schakel de TX2-70K uit en weer in.
7. In OnCue: Instellingen → Pyro → COM-poorten vernieuwen.

Als verbonden maar communicatie mislukt:
- Controleer baudrate (standaard: 9600).
- Verifieer dat de TX2-70K firmware compatibel is.
- Probeer de poll-snelheid te verlagen in geavanceerde instellingen.

Als OnCue traag aanvoelt of het timecode-display hapert:

1. Controleer CPU-gebruik in het health-dashboard — moet < 50% zijn.
2. Sluit andere applicaties (vooral browsers met video).
3. Stel Windows-energieplan in op Hoge Prestaties.
4. Verminder het aantal actieve outputs als CPU hoog is.
5. Voor grote shows (200+ cues): zorg dat je 16 GB RAM hebt.
6. Schakel de tijdlijnvisualisatie uit tijdens afspelen (vermindert GPU-belasting).
7. Controleer op schijfactiviteit — SSD sterk aanbevolen.
8. Schakel Windows Defender real-time scanning uit voor de OnCue-map.
9. Update je grafische drivers.
10. Als laatste redmiddel: herstart Windows vers voor de show.

Als licentie-activering mislukt:

1. Controleer je internetverbinding — activering vereist een eenmalige online check.
2. Verifieer dat de licentiecode correct is ingevoerd (kopieer/plak om typefouten te vermijden).
3. Controleer of de licentie niet al is geactiveerd op een andere machine (deactiveer eerst).
4. Zorg dat datum/tijd op je PC correct is.
5. Achter een bedrijfsfirewall? Whitelist api.oncuetimecode.nl.
6. Probeer OnCue uit te voeren als Administrator.

Werkt het nog steeds niet? Neem contact op met support met je licentiecode en de foutmelding. Wij kunnen de activeringsstatus aan onze kant controleren.