Das Rules-System ist das Herzstück der Automatisierung in Callers Caddy.
Du definierst, wann etwas passieren soll (Trigger), ob eine Bedingung erfüllt sein muss (Condition) – und was dann passiert (Action).
Alles ohne Scripting, alles per Klick.
Und damit du genau weißt, was es derzeit alles gibt, findest du hier nun die vollständige Auflistung der Trigger, Bedingungen, Aktionen und Parameter
Trigger
Ein Trigger ist der Startschuss für eine Regel. Ich habe aktuell 23 Trigger implementiert – von Song-Events über App-Start bis hin zu Tastenkürzel.
song_started
Wird ausgelöst, sobald ein Song zu spielen beginnt. Ideal, um z. B. automatisch ein Layout zu laden oder die Lyrics anzuzeigen.
song_stopped
Feuert, wenn ein Song vollständig gestoppt wurde – nicht bei Pause. Nützlich, um nach einer Nummer aufzuräumen oder weiterzuspringen.
song_paused
Reagiert auf den Moment, in dem du die Pause-Taste drückst. Du kannst damit z. B. das Fullscreen-Lyrics-Fenster wegräumen.
song_resumed
Wird aktiv, wenn ein pausierter Song weiterspielt. Damit holst du z. B. die Lyrics wieder in den Vordergrund.
song_changed
Feuert, sobald ein anderer Song geladen wird – egal ob aus der Playlist oder per Klick.
app_started
Wird genau einmal ausgelöst: beim Start der Anwendung. Damit lädst du dein Lieblingslayout oder setzt Standardwerte.
manager_closed
Reagiert darauf, wenn du den Playlist-Manager schließt. Die Standard-Systemregel fokussiert danach automatisch die Songliste.
play_timer
Feuert alle 10 Sekunden während der Wiedergabe. Damit kannst du zeitbasierte Warnungen einbauen – etwa wenn ein Patter zu lang läuft.
key_f1 bis key_f12
Jede F-Taste ist ein eigener Trigger. Du belegst sie frei mit beliebigen Aktionen – Play, Stop, Layout wechseln, was auch immer du brauchst.
key_space
Die Leertaste als Trigger. Standard-Systemregel: Play/Pause-Toggle – genau wie du es von einem Mediaplayer kennst.
key_l
Der Buchstabe L als Trigger. Standardmäßig öffnet er den Location-Dialog, damit du schnell deine Veranstaltung auswählen kannst.
key_p
Der Buchstabe P als Trigger. Standardmäßig toggelt er den Playlist-Manager.
Conditions
Eine Condition ist optional – sie schränkt ein, ob die Regel wirklich ausgeführt wird. Ist keine Condition gesetzt, läuft die Aktion immer. Alle Conditions außer einer sind parameterlos.
song_type_is_singing
Wahr, wenn der aktuelle Song als „Singing Call“ markiert ist. Damit steuerst du Regeln, die nur für Singings gelten sollen.
song_type_is_patter
Wahr, wenn der Song als „Patter“ eingetragen ist. So kannst du z. B. beim Patter-Stop einen anderen Ablauf einleiten als beim Singing.
lyrics_available
Wahr, wenn für den aktuellen Song eine Lyrics-Datei hinterlegt ist. Damit vermeidest du, dass du ein leeres Lyrics-Fenster öffnest.
lyrics_not_available
Das Gegenteil: wahr, wenn kein Lyrics-File vorhanden ist. Nutze das, um in diesem Fall eine alternative Aktion auszuführen.
loop_set
Wahr, wenn ein Loop konfiguriert ist – genauer: loop_in > 0,1 s oder loop_out weicht mehr als 0,5 s von der Song-Dauer ab. Du kannst damit den Loop-Toggle nur dann aktivieren, wenn ein Loop auch sinnvoll ist.
loop_not_set
Gegenteil von loop_set. Hilfreich, wenn du beim Song-Start automatisch einen Best-Loop setzen willst, aber nur dann, wenn noch keiner gesetzt wurde.
location_selected
Wahr, wenn du im Location-Dialog eine Veranstaltung ausgewählt hast. Damit sperrst du bestimmte Aktionen, bis die Lokation gesetzt ist.
location_not_selected
Wahr, wenn keine Lokation aktiv ist. Du kannst damit z. B. beim App-Start automatisch den Location-Dialog öffnen.
play_duration_above
Parameter: minutes (float, 0,5–60, Standard: 5) Wahr, wenn der Song bereits länger als X Minuten läuft. Damit baust du Zeitwarnungen ein – z. B. nach 7 Minuten Patter ein rotes Warnsignal.
Actions
Aktionen sind das, was die Regel tatsächlich macht. Ich habe 30 Aktionen implementiert, aufgeteilt in Bereiche wie Widget-Steuerung, Transport, Loop, Lyrics und mehr.
dock_open
Parameter: dock_name Macht ein Widget sichtbar und bringt es in den Vordergrund. Du nutzt das, um z. B. die Lyrics beim Song-Start automatisch einzublenden.
dock_close
Parameter: dock_name Versteckt ein Widget. Ideal, um beim Stop die Lyrics wegzuräumen oder das Layout aufzuräumen.
dock_fullsize
Parameter: dock_name Lässt ein Widget als schwebendes Fenster in ~90 % Bildschirmgröße erscheinen. Der vorherige Zustand wird gespeichert, damit du danach zurück kannst.
dock_focus
Parameter: dock_name Macht ein Widget sichtbar, bringt es nach vorn und gibt ihm den Tastatur-Fokus. Das ist der Unterschied zu dock_open.
auto_scroll_start
Startet das Auto-Scrolling im Lyrics-Widget. Du verwendest das typischerweise beim Start eines Singing Calls.
auto_scroll_stop
Hält das Auto-Scrolling an. Nützlich bei Pause oder Stop, damit der Scrolltext nicht weiterläuft.
layout_load
Parameter: layout_name Lädt ein gespeichertes Layout nach Name. Der Sonderfall "default" stellt den Zustand vor einem Fullsize-Fenster wieder her.
log_message
Parameter: message (Text) Schreibt eine Nachricht ins Rules-Log. Nützlich zum Debuggen von Regelketten oder zum Protokollieren von Ereignissen.
statusbar_message
Parameter: message (Text), duration_ms (int, Standard: 3000) Zeigt eine temporäre Nachricht in der Statusleiste an. Damit gibst du dir selbst kurze Hinweise während des Betriebs.
play
Startet die Wiedergabe (deferred via Timer, um Wiedereintritt zu vermeiden). Funktioniert auch, wenn bereits ein Song geladen aber gestoppt ist.
pause
Pausiert den laufenden Song. Wird nur ausgeführt, wenn der Pause-Button aktiv ist.
stop
Stoppt die Wiedergabe vollständig. Wird nur ausgeführt, wenn der Stop-Button aktiv ist.
fade_out
Leitet einen 5-Sekunden-Fade-Out ein. Der Song klingt sanft aus – ideal am Ende eines Squares.
play_pause_toggle
Wechselt zwischen Play und Pause. Das ist die Standard-Belegung der Leertaste.
auto_advance
Lädt den nächsten Song aus der Playlist. Damit baust du einen automatischen Ablauf ohne manuelles Klicken.
open_location_dialog
Öffnet den Location-Dialog. Praktisch als Startup-Regel, wenn du immer zuerst deine Veranstaltung auswählen willst.
toggle_manager
Toggelt die Sichtbarkeit des Playlist-Managers. Entspricht dem Standard-Shortcut auf P.
system_ping
Spielt einen Warnton ab: 880 Hz und 1100 Hz, je 150 ms, oder einen System-Beep als Fallback. Du nutzt das, um dich akustisch auf einen Zeitablauf hinzuweisen.
warn_background
Parameter: level (int, 1–2) Färbt den Play-Timer-Label farbig ein. Level 1 = Orange (#f59e0b), Level 2 = Rot (#ef4444). Damit siehst du auf einen Blick, dass etwas Aufmerksamkeit braucht.
warn_background_reset
Setzt die Hintergrundfarbe des Play-Timer-Labels zurück auf Normal. Verwende das beim Song-Stop oder -Wechsel.
tempo_change
Parameter: delta (int, −50…+50, Standard: +2) Verändert das „Today’s Tempo“ um den angegebenen Prozentpunkt. Die Änderung gilt nur für diese Session und wird nicht in der Datenbank gespeichert.
song_tempo_change
Parameter: delta (int, −50…+50, Standard: +2) Wie tempo_change, aber persistent: der neue Wert wird direkt in der Datenbank beim Song gespeichert.
pitch_change
Parameter: delta (float, −6,0…+6,0, Schritt: 0,5) Verschiebt die Tonhöhe um den angegebenen Halbtonschritt. Gut, um per Tastendruck schnell eine Oktave tiefer oder höher zu gehen.
volume_change
Parameter: delta (float, −1,0…+1,0, Schritt: 0,05) Ändert die Lautstärke des Songs relativ zum aktuellen Wert. Liegt der Bereich zwischen 0,0 und 1,0.
auto_set_best_loop
Analysiert den aktuellen Song und setzt automatisch den besten 64-Beat-Loop. Während der Analyse erscheint ein Overlay – der Song muss BPM-Daten haben.
toggle_loop_active
Schaltet die Loop-Active-Checkbox an oder aus. Damit aktivierst oder deaktivierst du den gesetzten Loop mit einer Taste.
goto_position
Parameter: position (choice: start / loop_in / loop_out / end, Standard: start) Springt zur angegebenen Position im Song. Wenn Crossfade aktiviert ist, wird der Übergang weich gestaltet.
lyrics_auto_width
Passt die Breite des Lyrics-Panels automatisch an den Inhalt an. Nützlich nach einem Layout-Wechsel, wenn die Breite nicht mehr stimmt.
photo_capture
Aktiviert die Kamera, wartet 500 ms für den Startup und macht dann eine Aufnahme. Du nutzt das, um automatisch ein Foto einer Gruppe zu machen.
photo_show
Zeigt das Photo-Dock als ~90 % Fullscreen-Fenster an. Damit präsentierst du das aufgenommene Bild groß auf dem Bildschirm.
Diese Liste ist schon beachtlich, wird aber vermutlich noch weiter wachsen. Es kommt auf die vielen Ideen der Callers Caddy Nutzer an.
Denk daran, du kannst deine Regeln auch speichern und mit anderen Callern tauschen.