BoothDock Studio kann andere Programme über jeden Schritt einer Sitzung informieren (Webhooks) und sich selbst von anderen Programmen steuern lassen (lokale API). Beides findest du im Admin-Bereich unter System → Automatisierung.
In BoothDock Studio 1.4.0 und älter heißen die Webhooks dort noch „Auslöser“.
Webhooks gibt es unter Windows und ab Version 1.5.10 auch auf iPad, iPhone und Mac. Die lokale API gibt es ab Version 1.4.0 auch auf iPad, iPhone und Mac, den Echtzeit-Export ab Version 1.5.2.
Typische Anwendungen: Licht oder DMX passend zum Countdown, ein Stream-Overlay, ein Zähler am Eingang – oder ein Stream Deck als Fernbedienung für die Box.

Webhooks einrichten
Trag eine Adresse (URL) ein, unter Windows auch ein Programm – oder beides. Bei jedem Ereignis ruft die Box alles auf, was eingetragen ist:
- Programm (nur Windows) – eine
.exe,.batoder.cmd. Aufruf:programm <ereignis> <param1> <param2> …. Jeder Wert kommt als eigenes Argument an, auch wenn er Leerzeichen enthält. Das Programm startet ohne Fenster, im eigenen Ordner. Ein PowerShell-Skript (.ps1) startest du über eine kleine.batdavor. - Adresse (URL) –
httpoderhttps, aufgerufen per GET:https://dein-server/hook?event_type=<ereignis>¶m1=…¶m2=…. Die Werte sind URL-kodiert; Parameter, die schon in deiner Adresse stehen, bleiben erhalten.
Auf iPad, iPhone und Mac gibt es nur die Adresse. Dort geht http:// nur ins lokale Netz (IP-Adresse oder .local) – Shelly, WLED und Tasmota im WLAN laufen also. Adressen im Internet brauchen https://.
Die Sitzung wartet nie auf deinen Webhook: Programm und Aufruf laufen nebenher, ein Aufruf darf höchstens 5 Sekunden dauern. Probe senden schickt sofort ein session_start – so prüfst du die Verbindung, ohne eine Sitzung zu starten.
Programm und Adresse lassen sich nur direkt an der Box einstellen, nicht über den Hub: Ein Programmpfad ist ein Recht, etwas auf dem Rechner auszuführen.
Eigene Adresse je Ereignis
Ab Version 1.5.10 kannst du unter Eigene Adresse je Ereignis (optional) jedem Ereignis zusätzlich eine eigene Adresse geben – etwa für eine Shelly-Steckdose, WLED oder Tasmota im WLAN, die beim Countdown oder bei der Aufnahme schaltet. Beispiel für countdown_start: http://192.168.1.50/relay/0?turn=on.
Die Box ruft diese Adresse zusätzlich zu Programm und Adresse oben auf, als einfachen GET ohne angehängte Werte. Die bisherige Adresse und vorhandene Skripte laufen unverändert weiter. countdown kommt jede Sekunde; bei file_upload ruft die Box die eigene Adresse einmal je Sitzung auf (die allgemeine Adresse weiter je Datei).
Ereignisse
| Ereignis | Wann | Parameter |
|---|---|---|
session_start | Ein Gast startet eine Sitzung, der Modus steht fest | 1: Modus (PrintOnly, PrintAndGIF, OnlyGIF, SlowMoOr360, Video), 2: BoothDock-Modus (photo, gif, boomerang, video, slowmo, ai) |
countdown_start | Der Countdown beginnt | 1: Sekunden |
countdown | Jede Sekunde des Countdowns | 1: Fortschritt in Prozent (ab 0) |
capture_start | Der Countdown ist durch, die Aufnahme beginnt | – |
file_download | Die Kamera hat ein Foto abgelegt | 1: Dateiname, 2: vollständiger Pfad |
processing_start | Die Bearbeitung beginnt | je Kamera-Original ein Dateiname, als letzter Wert die Druckdatei (derzeit leer) |
sharing_screen | Der Ergebnisbildschirm erscheint (einmal je Sitzung) | – |
printing | Ein Blatt geht an einen Drucker | 1: Datei (derzeit leer), 2: Kopien, 3: Drucker |
file_upload | Eine Datei ist im Hub angekommen (je Datei) | 1: Pfad auf der Box, 2: Galerie-Link, 3: Typ (print, photo, original, animation, boomerang, video), 4: Album (Eventname) |
lead_submitted | Ein Gast hat das Formular Gästedaten (Formular) abgeschickt (ab 1.5.0) | – (die Antworten selbst stehen nur im CSV-Export) |
session_end | Die Sitzung endet – fertig, abgebrochen, abgelaufen oder gelöscht | – |
Beispiel für eine .bat, die jedes Ereignis mitschreibt: echo %DATE% %TIME% %* >> "%~dp0ereignisse.log"
Lokale API
Andere Programme steuern die Box per HTTP – etwa ein Stream Deck, ein eigenes Skript oder eine 360°-Steuerung auf dem Handy.
- Einschalten: System → Automatisierung → API einschalten. Ab Werk ist die API aus. Port 1500, änderbar.
- Adresse:
http://localhost:1500/api/<befehl>(oder127.0.0.1). Ab Werk nimmt die Box nur Anfragen von diesem Rechner an. - Passwort: 16 Zeichen, angezeigt im selben Abschnitt – kopieren oder neu erzeugen. Mitgeben als
?password=…, als KopfzeileX-Api-Passwordoder alsAuthorization: Bearer …. Nurpinggeht ohne. - Antwort: immer HTTP 200 mit JSON, zum Beispiel
{"ApiVersion":1,"Command":"cancel","IsSuccessful":true,"ErrorMessage":""}. Ob es geklappt hat, steht inIsSuccessful, der Grund im Fehlerfall inErrorMessage. Einige Befehle liefern zusätzlichData.
Ein vollständiger Aufruf: http://localhost:1500/api/start?mode=print&password=DEIN-PASSWORT
Aus dem Netz steuern (Handy, Tablet, 360°)
Schalte zusätzlich Auch aus dem Netzwerk erreichbar ein. Dann nimmt die Box Anfragen von Geräten im selben WLAN/LAN an – nie aus dem Internet.
- Adresse fürs Handy: steht in der Statuszeile, zum Beispiel
http://192.168.1.20:1500. Das Beispiel darunter zeigt dann gleich die passende Adresse. - Ohne IP-Eingabe: Die Box meldet sich im Netz selbst an (mDNS/Bonjour, Diensttyp
_boothdock._tcp, Name „BoothDock" plus Rechnername). Apps, die danach suchen, finden sie automatisch. - Sperre: Schickt ein Gerät zehnmal in zehn Minuten ein falsches Passwort, ist es 15 Minuten gesperrt. Dieser Rechner selbst wird nie gesperrt.
- Nur im eigenen Netz: Das Passwort geht unverschlüsselt durchs Netz. Nutze den Netzbetrieb nur in deinem eigenen, geschützten WLAN – nicht im offenen Gäste-WLAN der Location.
- Firewall: Die Installation richtet die Freigabe ein, nur für private Netzwerke. Zeigt die Statuszeile eine Firewall-Warnung, installiere BoothDock Studio erneut oder erlaube es in Windows unter „App durch die Firewall zulassen". Führt Windows das WLAN als öffentlich, kommen Geräte nicht herein – stell das Profil in den Netzwerkeigenschaften auf Privat.
Befehle
| Befehl | Wirkung |
|---|---|
start?mode=print | Startet eine Sitzung. Modi: print (Foto), gif, boomerang, slowmo (360°; ohne 360° der Boomerang), video, ai. Geht nur vom Startbildschirm aus, nur mit freigeschaltetem Modus und nicht bei gesperrter Box. Mit Vorlage, Stil und Hintergrund: siehe unten. |
auswahl?mode=print | Liefert in Data, was es für diesen Modus zu wählen gibt: vorlagen (Id und Name; leer, wenn nur eine Vorlage freigegeben ist – die steht dann in vorgabeVorlage), hintergruende je Vorlage und im Modus ai die stile (ab 1.5.13). |
cancel | Bricht die laufende Sitzung ab und geht zurück zum Startbildschirm. |
status | Liefert in Data: Gastmodus an/aus, aktueller Bildschirm, Modus, gesperrt ja/nein – ab 1.5.13 auch sperrgrund (manuell oder zeitfenster) und oeffnetUm. |
print?count=1 | Druckt das letzte Ergebnis noch einmal (1 bis 10 Blätter). Videos lassen sich nicht drucken. |
lockscreen/show | Sperrt die Box mit „Einen Moment – gleich geht's weiter." oder deinem eigenen Text und Bild (siehe „Sperrbildschirm“ unten). Die Admin-Ecke bleibt erreichbar. Ab 1.5.13 bleibt die Sperre auch über einen Neustart der App bestehen. |
lockscreen/exit | Hebt die Sperre auf – ab 1.5.13 auch die Sperre durch das Zeitfenster, bis zum nächsten Wechsel. |
share/email?email=… | Schickt das letzte Ergebnis per E-Mail – braucht die Hub-Kopplung und die Ergebnis-Aktion „Per E-Mail erhalten“ (System → Betrieb → Ergebnis-Aktionen (Gast); bis 1.4.0 der Schalter „Foto per E-Mail (Gast)“ unter Design → Screens). |
share/sms | Gibt es nicht; die Antwort sagt das ehrlich (IsSuccessful: false). |
createtestevent?name=… | Legt ein Testevent an und macht es aktiv. Data enthält eventId und eventName. Ohne Namen gibt es einen mit Datum. Nur außerhalb des Gastmodus (ab 1.5.4). |
deletetestevent?eventId=… | Löscht ein Testevent, das über die API angelegt wurde – andere Events nie. Nur außerhalb des Gastmodus (ab 1.5.4). |
ping | Prüft ohne Passwort, ob die API läuft. |
Antwortet die Box nicht innerhalb von 15 Sekunden, kommt IsSuccessful: false mit einem Hinweis zurück.
Sitzung mit Vorlage, Stil und Hintergrund starten
Ab Version 1.5.13 nimmt start die Wahl gleich mit – die Box überspringt dann genau diese Auswahl-Bildschirme:
vorlage=<Id>(odertemplate=) – die Vorlage, nur im Modusprint(Foto). Die Ids liefertauswahl?mode=print.stil=<Id>(oderstyle=) – der KI-Stil, nur im Modusai.hintergrund=<Id>(oderbackground=) – der Hintergrund der Freistellung, passend zur Vorlage.
Beispiel: http://localhost:1500/api/start?mode=print&vorlage=hochzeit-gold&hintergrund=strand&password=DEIN-PASSWORT
Eine unbekannte oder nicht passende Id startet keine Sitzung: IsSuccessful ist false, ErrorMessage nennt den Grund. Datenschutz-Zustimmung und Gästedaten-Formular zeigt die Box weiterhin selbst – sie gelten für den Gast vor der Box und lassen sich nicht über die API vorwegnehmen.
Sperrbildschirm
Unter Events → Sperrbildschirm (ab 1.5.13) legst du fest, was eine gesperrte Box zeigt: eigenen Text, ein eigenes Bild und – beim Zeitfenster – einen großen Countdown bis zur Öffnung.
- Zeitfenster je Event: Mit Öffnet um und Schließt um ist die Box vor dem Start und nach dem Ende gesperrt.
- Entsperren am Gerät: Ist eine Betreiber-PIN eingerichtet (System → Schutz), zeigt der Sperrbildschirm ein kleines Schloss. Wer die PIN kennt, entsperrt die Box. Vor dem Start freigegeben, bleibt sie bis zum Ende offen.
- Aus der Ferne: Im Hub unter Boxen sperrst und entsperrst du jede Box, die das kann (Studio ab 1.5.13). Dasselbe geht über die Station und mit
lockscreen/show/lockscreen/exit.
Eine laufende Sitzung bricht weder die Sperre aus dem Hub noch das Zeitfenster ab – die Box sperrt, sobald der Gast fertig ist.
Echtzeit-Export
Im selben Reiter: Jede fertige Datei landet sofort auf der Box selbst (Lokale Kopie) – auch ohne Hub, sortiert nach Event und Typ (Drucke, Originale, GIFs, Videos – einzeln abschaltbar). Diese Kopie wird nie automatisch gelöscht. Unter USB-Stick / Zweitordner kommt ein zweites Ziel dazu: Automatisch auf USB-Stick schreiben schreibt auf jeden eingesteckten Stick, Verpasste Dateien nachholen schreibt nach, was ohne Stick entstand. Alternativ trägst du einen Fester Zweitordner (hat Vorrang) ein, etwa einen Cloud-Ordner (OneDrive, Dropbox). Löscht ein Gast seine Sitzung am Automaten, verschwinden auch die Kopien. Auf iPad und iPhone: In der Dateien-App unter „Auf meinem iPad › BoothDock Studio › Export“. In BoothDock Studio 1.5.3 und älter gibt es stattdessen nur den Exportordner.
Start per Fernbedienung
Im selben Reiter lernst du unter Start per Fernbedienung eine Taste an. Presenter, USB-Taster und Fußschalter senden meist die Leertaste; die ist voreingestellt. Bei Startet wählst du, was die Taste am Startbildschirm auslöst: Wie Berühren (normaler Ablauf) oder gleich einen Modus, zum Beispiel 360° an der Plattform. In BoothDock Studio 1.4.0 und älter gibt es die Taste nur für 360°, siehe 360° / Zeitlupe.
Fehlersuche
- Nichts passiert: Steht im Protokoll etwas? Webhooks schreiben nach
webhooks.log(bis 1.4.0:ausloeser.log), die API nachlokale-api.log– beide im Ordner%LocalAppData%\Boothdock Studio\logs(Windows). Abgelehnte Anfragen (falsches Passwort, fremdes Gerät) stehen dort höchstens einmal pro Minute. - „Invalid password." – Passwort neu kopieren; nach Neues Passwort gilt das alte nicht mehr.
- „The booth is not on the start screen …" –
startgeht nur vom Startbildschirm. Erstcancel, dannstart. - „Too many failed attempts …" – das Gerät hat zu oft ein falsches Passwort geschickt. 15 Minuten warten, Passwort prüfen.
- Handy erreicht die Box nicht, am Rechner geht alles: fast immer die Windows-Firewall oder ein als öffentlich geführtes WLAN – siehe oben. Beide Fälle meldet die Statuszeile.