The Rules system is the heart of automation in Callers Caddy. <\/p>\n\n\n\n
You define, When<\/strong> something is supposed to happen (trigger), whether<\/strong> a condition must be met \u2013 and What<\/strong> Then (action) happens. <\/p>\n\n\n\n All without scripting, all with a click.<\/p>\n\n\n\n And so that you know exactly what's currently available, here is the complete list of triggers, conditions, actions, and parameters.<\/p>\n\n\n\n A trigger is the starting signal for a rule. I currently have 23 triggers implemented \u2013 from song events and app launches to keyboard shortcuts.<\/p>\n\n\n\n Triggered as soon as a song starts playing. Ideal for automatically loading a layout or displaying lyrics, for example.<\/p>\n\n\n\n It fires when a song has been completely stopped \u2013 not during pause. Useful for tidying up after a track or skipping ahead.<\/p>\n\n\n\n It reacts to the moment you press the pause button. For example, you can use it to clear the fullscreen lyrics window.<\/p>\n\n\n\n Activates when a paused song resumes playing. This allows you to, for example, bring the lyrics back to the foreground.<\/p>\n\n\n\n It fires as soon as another song is loaded \u2013 whether from the playlist or by clicking. <\/p>\n\n\n\n This is triggered exactly once: when the application starts. This loads your favorite layout or sets default values.<\/p>\n\n\n\n This reacts when you close the playlist manager. The default system rule then automatically focuses on the song list. <\/p>\n\n\n\n It fires every 10 seconds during playback. This allows you to implement time-based warnings \u2013 for example, if a pattern runs for too long.<\/p>\n\n\n\n Each F-key is its own trigger. You can freely assign them any actions you like \u2013 play, stop, change layout, whatever you need.<\/p>\n\n\n\n The spacebar as a trigger. Standard system rule: Play\/Pause toggle \u2013 just like you know it from a media player.<\/p>\n\n\n\n The letter L acts as a trigger. By default, it opens the location dialog so you can quickly select your event.<\/p>\n\n\n\n The letter P acts as a trigger. By default, it toggles the playlist manager.<\/p>\n\n\n\n A condition is optional \u2013 it restricts whether the rule is actually executed. If no condition is set, the action always runs. All conditions except one are parameterless.<\/p>\n\n\n\n True, if the current song is marked as a "Singing Call". This allows you to control rules that only apply to singing calls.<\/p>\n\n\n\n True, if the song is entered as a "Patter". This allows you, for example, to initiate a different sequence at the Patter Stop than at the Singing.<\/p>\n\n\n\n True, if a lyrics file is embedded for the current song. This prevents you from opening an empty lyrics window.<\/p>\n\n\n\n The opposite is true if no lyrics file is present. Use this to perform an alternative action in that case.<\/p>\n\n\n\n True if a loop is configured \u2013 more precisely: loop_in > 0.1 s or loop_out deviates from the song duration by more than 0.5 s. This means you can only activate the loop toggle if a loop is actually useful.<\/p>\n\n\n\n The opposite of `loop_set`. Useful if you want to automatically set a best loop when the song starts, but only if one hasn't been set yet.<\/p>\n\n\n\n True, if you have selected an event in the location dialog. This locks certain actions until the location is set.<\/p>\n\n\n\n True if no location is active. This allows you, for example, to automatically open the location dialog when the app starts.<\/p>\n\n\n\n Parameter: Actions are what the rule actually does. I've implemented 30 actions, divided into areas like widget control, transport, loop, lyrics, and more.<\/p>\n\n\n\n Parameter: Parameter: Parameter: Parameter: Starts auto-scrolling in the lyrics widget. You typically use this when starting a singing call.<\/p>\n\n\n\n Stops auto-scrolling. Useful when pausing or stopping, so the scrolling text doesn't continue.<\/p>\n\n\n\n Parameter: Parameter: Parameter: Starts playback (deferred via timer to prevent re-entry). Also works if a song is already loaded but stopped.<\/p>\n\n\n\n Pauses the current song. Only executed when the pause button is active.<\/p>\n\n\n\n Stops playback completely. Only executed when the stop button is active.<\/p>\n\n\n\n It introduces a 5-second fade-out. The song fades out gently \u2013 ideal at the end of a square riff.<\/p>\n\n\n\n Switches between play and pause. That's the default function of the spacebar.<\/p>\n\n\n\n Loads the next song from the playlist. This allows you to create an automated sequence without manual clicking.<\/p>\n\n\n\n Opens the location dialog. Useful as a startup rule if you always want to select your event first.<\/p>\n\n\n\n Toggles the visibility of the playlist manager. Corresponds to the standard shortcut on Plays a warning tone: 880 Hz and 1100 Hz, each for 150 ms, or a system beep as a fallback. You use this to audibly alert yourself to a time elapse.<\/p>\n\n\n\n Parameter: Resets the background color of the play timer label to normal. Use this when stopping or changing songs.<\/p>\n\n\n\n Parameter: Parameter: Parameter: Parameter: Analyzes the current song and automatically sets the best 64-beat loop. An overlay appears during the analysis \u2013 the song must have BPM data.<\/p>\n\n\n\n Toggles the Loop Active checkbox on or off. This allows you to activate or deactivate the set loop with a single button press.<\/p>\n\n\n\n Parameter: Automatically adjusts the width of the lyrics panel to the content. Useful after a layout change when the width is no longer correct.<\/p>\n\n\n\n Activate the camera, wait 500 ms for startup, and then take a picture. You can use this to automatically take a group photo.<\/p>\n\n\n\n The photo dock displays as a fullscreen window (approximately 90 %). This allows you to present the captured image large on the screen.<\/p>\n\n\n\n <\/p>\n\n\n\n This list is already impressive, but it will likely grow even further. It all depends on the many ideas from Callers Caddy users.<\/p>\n\n\n\n Remember, you can Save your rules too<\/a> and exchange with other callers.<\/p>","protected":false},"excerpt":{"rendered":" The rules system is the heart of automation in Callers Caddy. You define when something should happen (trigger), whether a condition must be met (condition), and what happens then (action). All without scripting, all with a single click. And so you know exactly what's currently available, here's the complete list of triggers\u2026 Read more<\/a><\/p>","protected":false},"author":1,"featured_media":298,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-297","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-funktionen"],"_links":{"self":[{"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/posts\/297","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/comments?post=297"}],"version-history":[{"count":1,"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/posts\/297\/revisions"}],"predecessor-version":[{"id":299,"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/posts\/297\/revisions\/299"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/media\/298"}],"wp:attachment":[{"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/media?parent=297"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/categories?post=297"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/callerscaddy.de\/en\/wp-json\/wp\/v2\/tags?post=297"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\n\n\n\nTrigger<\/h2>\n\n\n\n
song_started<\/h3>\n\n\n\n
song_stopped<\/h3>\n\n\n\n
song_paused<\/h3>\n\n\n\n
song_resumed<\/h3>\n\n\n\n
song_changed<\/h3>\n\n\n\n
app_started<\/h3>\n\n\n\n
manager_closed<\/h3>\n\n\n\n
play_timer<\/h3>\n\n\n\n
key_f1 to key_f12<\/h3>\n\n\n\n
key_space<\/h3>\n\n\n\n
key_l<\/h3>\n\n\n\n
key_p<\/h3>\n\n\n\n
\n\n\n\nConditions<\/h2>\n\n\n\n
song_type_is_singing<\/h3>\n\n\n\n
song_type_is_pattern<\/h3>\n\n\n\n
lyrics_available<\/h3>\n\n\n\n
lyrics not available<\/h3>\n\n\n\n
loop_set<\/h3>\n\n\n\n
loop_not_set<\/h3>\n\n\n\n
location_selected<\/h3>\n\n\n\n
location_not_selected<\/h3>\n\n\n\n
play_duration_above<\/h3>\n\n\n\n
minutes<\/code> (float, 0.5-60, default: 5)<\/strong> True if the song has been playing for more than X minutes. This allows you to implement time warnings \u2013 e.g., a red warning signal after 7 minutes of pattern.<\/p>\n\n\n\n
\n\n\n\nActions<\/h2>\n\n\n\n
dock_open<\/h3>\n\n\n\n
dock_name<\/code><\/strong> Makes a widget visible and brings it to the foreground. You can use this to, for example, automatically display the lyrics when a song starts.<\/p>\n\n\n\ndock_close<\/h3>\n\n\n\n
dock_name<\/code><\/strong> It hides a widget. Ideal for clearing away the lyrics or tidying up the layout when stopping.<\/p>\n\n\n\ndock_fullsize<\/h3>\n\n\n\n
dock_name<\/code><\/strong> Displays a widget as a floating window at approximately 90x screen size. The previous state is saved so you can revert to it later.<\/p>\n\n\n\ndock_focus<\/h3>\n\n\n\n
dock_name<\/code><\/strong> Makes a widget visible, brings it to the forefront. and<\/em> gives him keyboard focus. That's the difference to dock_open<\/code>.<\/p>\n\n\n\nauto_scroll_start<\/h3>\n\n\n\n
auto_scroll_stop<\/h3>\n\n\n\n
layout_load<\/h3>\n\n\n\n
layout_name<\/code><\/strong> Loads a saved layout by name. The special case \""default"\"<\/code> restores the state in front of a full-size window.<\/p>\n\n\n\nlog_message<\/h3>\n\n\n\n
message<\/code> (Text)<\/strong> Writes a message to the rules log. Useful for debugging rule chains or logging events.<\/p>\n\n\n\nstatusbar_message<\/h3>\n\n\n\n
message<\/code> (Text), duration_ms<\/code> (int, Standard: 3000)<\/strong> Displays a temporary message in the status bar. This allows you to give yourself brief reminders during operation.<\/p>\n\n\n\nplay<\/h3>\n\n\n\n
pause<\/h3>\n\n\n\n
Stop<\/h3>\n\n\n\n
fade_out<\/h3>\n\n\n\n
play_pause_toggle<\/h3>\n\n\n\n
auto_advance<\/h3>\n\n\n\n
open_location_dialog<\/h3>\n\n\n\n
toggle_manager<\/h3>\n\n\n\n
P<\/code>.<\/p>\n\n\n\nsystem_ping<\/h3>\n\n\n\n
warn_background<\/h3>\n\n\n\n
level<\/code> (int, 1\u20132)<\/strong> Color the play timer label. Level 1 = Orange (#f59e0b<\/code>), Level 2 = Red (#ef4444<\/code>This way you can see at a glance that something needs attention.<\/p>\n\n\n\nwarn_background_reset<\/h3>\n\n\n\n
tempo_change<\/h3>\n\n\n\n
delta<\/code> (int, \u221250\u2026+50, default: +2)<\/strong> Changes the "Today's Pace" by the specified percentage. The change only applies to this session and is not saved in the database.<\/p>\n\n\n\nsong_tempo_change<\/h3>\n\n\n\n
delta<\/code> (int, \u221250\u2026+50, default: +2)<\/strong> How tempo_change<\/code>, but persistent: the new value is stored directly in the database with the song.<\/p>\n\n\n\npitch_change<\/h3>\n\n\n\n
delta<\/code> (float, \u22126.0\u2026+6.0, step: 0.5)<\/strong> Shifts the pitch by the specified semitone. Useful for quickly going an octave lower or higher with the press of a key.<\/p>\n\n\n\nvolume_change<\/h3>\n\n\n\n
delta<\/code> (float, \u22121.0\u2026+1.0, step: 0.05)<\/strong> Changes the song's volume relative to the current value. The range is between 0.0 and 1.0.<\/p>\n\n\n\nauto_set_best_loop<\/h3>\n\n\n\n
toggle_loop_active<\/h3>\n\n\n\n
goto_position<\/h3>\n\n\n\n
position<\/code> (choice: start<\/code> \/ loop_in<\/code> \/ loop_out<\/code> \/ end<\/code>, Standard: start<\/code>)<\/strong> Jumps to the specified position in the song. If crossfade is enabled, the transition will be smooth.<\/p>\n\n\n\nlyrics_auto_width<\/h3>\n\n\n\n
photo_capture<\/h3>\n\n\n\n
photo_show<\/h3>\n\n\n\n