Fernsteuerung (Stream Deck, Companion, OSC)

Es gibt zwei Wege, die Buttons von Show Clock mit etwas anderem als der Maus zu drücken:

1. Tastenkürzel – geht heute schon, mit allem, was einen Tastendruck senden kann: die Hotkey-Aktion eines Stream Decks, ein MIDI-zu-Taste-Tool, ein Presenter. Das Browserfenster mit Show Clock muss dafür vorne liegen.
2. Der Steuerlink – eine geheime Webadresse pro Zeitplan. Bitfocus Companion, ein OSC-Controller (über Companion oder TouchDesigner) oder ein beliebiges Skript ruft sie auf; der Operator-Tab braucht keinen Fokus und darf sogar auf einem anderen Rechner laufen als das Stream Deck.

Stream Deck mit Tastenkürzeln

Zieh in der Stream-Deck-App System ▸ Hotkey auf eine Taste und drück im Feld Hotkey das gewünschte Kürzel. Show Clock reagiert, als hättest du es getippt.

Gut zu wissen:

• Nimm N für „Nächster Slot“, nicht die Leertaste. Hat ein Button in Show Clock den Tastaturfokus, drückt die Leertaste diesen Button.
• Die Pfeile ändern den Offset nur, wenn der Fokus nicht auf einer Zeile des Ablaufplans liegt. Auf einer fokussierten Zeile gehören ↑ / ↓ der Zeile (und Alt+↑ / ↓ verschiebt sie), der Offset der Show bleibt, wo er ist. Klick vor der Show einmal auf die große Uhr, dann gehen die Pfeile an den Offset.
• Tastaturlayout: Auf einer deutschen Tastatur ist die Taste + +1 Min, ein Kürzel für +5 Min gibt es dort nicht – nimm eine Stream-Deck-Multi Action mit fünfmal +1 oder den Steuerlink unten. Auf US-/UK-Layout ist = +1 Min und Shift+= +5 Min. − und Shift+− gehen auf beiden.
• Vorheriger Slot (Shift+N) macht den Slot vor dem laufenden wieder live. Wurde der laufende Slot mit „Nächster Slot“ gestartet, wird das zurückgenommen. Hat er zu seiner Zeit von selbst begonnen, spielt der Act davor weiter und die Show läuft um die nötigen Minuten später (der Offset wächst; Curfew, Einlass und Übertragung bleiben stehen). Drück „Nächster Slot“, wenn der Act von der Bühne geht. Beim ersten Slot und über eine schon begonnene feste Zeit hinweg passiert nichts.
• Kürzel pausieren, während du in einem Feld tippst oder ein Dialog (Sheet) offen ist, und sie erreichen nur das Fenster, das vorne liegt. Macht der Laptop am FOH nebenbei noch andere Dinge, nimm lieber den Steuerlink.

Der Steuerlink

Ein Steuerlink ist eine geheime Adresse für einen Zeitplan. Alles, was eine Webanfrage senden kann, fährt damit die Show: ein Companion-Button, ein OSC-Controller über Companion oder TouchDesigner, ein Shell-Skript.

Er funktioniert, solange Show Clock auf deinem Operator-Gerät offen ist und Fernsteuerung auf diesem Gerät eingeschaltet ist. Show Clock schaut jede Sekunde nach neuen Befehlen, ein Druck kommt also nach ein bis zwei Sekunden an. Einen Befehl, den niemand innerhalb von 30 Sekunden abholt, verwirft Show Clock – ein „Next“, gedrückt während der Laptop schlief, feuert nicht zehn Minuten später. Befehle laufen genau wie ein Klick: deine anderen Geräte und jeder Share-Link ziehen mit.

So bekommst du deinen Steuerlink

1. Öffne den Zeitplan, den du fährst. Klick in der Steuerleiste auf Show-Steuerung (am Handy: ⚙ Einstellungen ▸ Show-Steuerung · Blackout · Fernsteuerung…).
2. Tipp unter Fernsteuerung auf Steuerlink erstellen und dann auf Kopieren. Er sieht so aus: https://squaresmile.de/api/show-clock/control/scc_… – der Teil nach /control/ ist dein Token. Direkt darunter steht die Status-Adresse für einen Button, der die Restzeit zeigt.
3. Schalte Fernsteuerung auf diesem Gerät ein.

Der Link wird nur einmal angezeigt. Danach zeigt das Panel nur noch die letzten vier Zeichen und wann er zuletzt benutzt wurde. Wenn er weg ist, tipp auf Link erneuern (zweimal, zur Bestätigung) und trag den neuen in deinen Controller ein.

Was du senden kannst

Häng eine Aktion an den Link. Alle Beispiele nutzen https://squaresmile.de/api/show-clock/control/TOKEN – ersetz TOKEN durch deinen.

Blackout und die Nachricht an den Act erklärt Blackout, stage messages, Artist link, OBS and the stage wall. Ein so gesendeter Cue erscheint in Großbuchstaben, wie aus dem Fenster Cue an die Bühne. Eine Nachricht übernimmt die Wahl „Auch auf Crew-Screens“, die du zuletzt im Panel Show-Steuerung getroffen hast.

Ein einfaches GET (die Adresse aufrufen) reicht – mit Absicht, denn das Generic HTTP-Modul von Companion und die meisten OSC-zu-HTTP-Brücken können nur GETs senden. Kann dein Tool POST, schick JSON an den Link selbst:

{ "action": "offset", "value": -1 }

Ein Formular-Body (action=offset&value=-1) geht auch. Aktionsnamen gehen mit _ oder - (offset_reset = offset-reset).

Antworten: 202 mit {"ok":true,"id":…,"action":"next","value":null} heißt: angenommen. 422 heißt: Aktion oder Wert falsch – error sagt, was: unknown_action, missing_value, invalid_value oder value_too_long. 404 heißt: Token falsch oder widerrufen. 429 heißt: zu viele Drücke – pro Link gehen bis zu 20 Befehle in 10 Sekunden.

Die Uhr auf einem Button: die Status-Adresse

…/TOKEN/status antwortet mit dem, was gerade auf der Bühne läuft – zum Anzeigen auf einer Stream-Deck-Taste:

{
  "ok": true, "online": true,
  "slot": "Band A", "next": "Band B",
  "remaining": 734, "remaining_text": "12:14", "over": false,
  "offset": 120, "offset_text": "+2:00",
  "blackout": false, "cue": "5 MIN", "paused": false,
  "reported_at": "2026-09-29T20:14:05Z", "age": 2
}

remaining sind die Sekunden, die im laufenden Slot übrig sind (negativ, wenn er überzieht; dann ist over true), offset ist der Offset in Sekunden. Hat sich Show Clock eine Minute lang nicht gemeldet – Tab zu, Fernsteuerung aus, kein Netz –, ist online false und die Felder sind leer. Frag höchstens einmal pro Sekunde ab.

Bitfocus Companion

Leg eine Verbindung Generic: HTTP Requests an. Lass Base URL leer (oder setz sie auf https://squaresmile.de/api/show-clock/control/TOKEN/ und tipp pro Button nur noch die Aktion).

Button-Rezepte – jeweils eine GET-Aktion auf press:

Ein laufender Countdown auf einem Button: Leg unter Triggers einen Trigger mit Zeitintervall 1 Sekunde an, dessen Aktion ein GET auf …/TOKEN/status ist – JSON Response Data Variable auf sc_status, JSON Stringify Result aus. Dann setz den Text eines Buttons auf einen Ausdruck (ab Companion 3.2), zum Beispiel jsonpath($(custom:sc_status), '$.remaining_text') für die Restzeit oder jsonpath($(custom:sc_status), '$.slot') für die Band auf der Bühne.

OSC über Companion

Companion hört selbst auf OSC (Settings ▸ Protocols; Standard-Port 12321). Richte deinen iPad-OSC-Controller auf den Companion-Rechner und schick /location/<page>/<row>/<column>/press, um den Companion-Button mit dem GET zu drücken – zum Beispiel /location/1/0/0/press für den NEXT-Button auf Seite 1 oben links.

TouchDesigner

Leg einen Web Client DAT an (webclient1). Eine Aktion aus Python auslösen – aus einem Button-Callback oder dem Callback eines OSC In DAT:

BASE = 'https://squaresmile.de/api/show-clock/control/TOKEN'

def onReceiveOSC(dat, rowIndex, message, bytes, timeStamp, address, args, peer):
    if address == '/showclock/next':
        op('webclient1').request(BASE + '/next', 'GET')
    elif address == '/showclock/offset' and args:
        op('webclient1').request(BASE + '/offset/' + str(int(args[0])), 'GET')
    return

So werden /showclock/next und /showclock/offset -1 von deinem OSC-Controller zu Show-Clock-Drücken. Für den Status fragst du BASE + '/status' über einen Timer CHOP ab und liest die Antwort im onResponse-Callback des Web Client DAT mit json.loads.

curl und Skripte

TOKEN=scc_…   # dein Token
curl https://squaresmile.de/api/show-clock/control/$TOKEN/next
curl https://squaresmile.de/api/show-clock/control/$TOKEN/offset/-1
curl -X POST https://squaresmile.de/api/show-clock/control/$TOKEN \
     -H 'Content-Type: application/json' \
     -d '{"action":"cue","value":"5 MIN"}'
curl https://squaresmile.de/api/show-clock/control/$TOKEN/status

Pass auf den Link auf

• Bewahr ihn in Companion oder TouchDesigner auf, nicht in einem Gruppenchat oder einer geteilten Show-Datei.
• Erneuer den Link nach einer Tour, nachdem du das Stream Deck oder die Companion-Konfiguration verliehen hast, oder immer, wenn du nicht sicher bist, wer ihn hat. Der alte Link ist sofort tot, und was er noch in der Warteschlange hatte, fliegt raus. Trag den neuen Link in deinen Controller ein.
• Widerruf ihn, wenn du keine Fernsteuerung mehr brauchst (Widerrufen, dann zur Bestätigung nochmal tippen). Jeder Zeitplan hat seinen eigenen Link; einen zu widerrufen lässt die anderen in Ruhe. Ein Gerät mit eingeschalteter Fernsteuerung schaltet sie dann selbst aus.
• Befehle werden nur ein paar Minuten aufbewahrt und dann gelöscht; nichts, was ein Controller sendet, landet in deiner Show.

Weiter

• Blackout, stage messages, Artist link, OBS and the stage wall – Blackout, Bühnennachrichten, der Artist-Link und die OBS-Quelle.
• Getting started – Offset, Cue und der Rest des Operator-Bildschirms.
• Multiple devices & accounts – die Show von mehreren eigenen Geräten fahren.