Command Quick Reference
Every program log command AutoCast understands, on one page. For full details on any command, see Program Logs.
Commands begin with a single # followed by the command name and parameters. Comments begin with ## and are ignored by AutoCast.
Structure
| Command | What It Does |
|---|---|
## text | Comment — ignored by AutoCast. Use to annotate the log. |
# Hour N | Marks the start of hour N (0–23). Required for time-based commands to work correctly. |
Timing & Flow Control
| Command | What It Does |
|---|---|
# Time-Correct@:MM:SS | Skips forward in the log if needed to ensure AutoCast is in position by the specified minute:second of the current hour. If already past that time, ignored. |
# Interrupt@:MM:SS [fade] | Fades out current audio at the specified time and jumps to the next event. Optional fade duration in seconds overrides the default. |
# Pause-For HH:MM:SS [label] | Pauses automation for the specified duration, then resumes. Optional label shown on deck during pause. |
# Pause-Until HH:MM:SS | Pauses automation until the specified wall-clock time. Accepts Noon and Midnight as keywords. |
# FadeInto N | Crossfades the currently playing audio into the next item over N seconds, immediately. |
Live Input
| Command | What It Does |
|---|---|
# Live-For [+vol] HH:MM:SS [label] | Opens live input for the specified duration, then closes it automatically. Optional volume adjustment in dB. Optional label shown on deck. |
# Live On | Opens live input indefinitely. Automation continues to next command. |
# Live Off | Closes live input and resumes automation. |
# LiveAssist On | Enables DJ-controlled mode — AutoCast waits after each item for manual advance. |
# LiveAssist Off | Disables LiveAssist mode; returns to full automation. |
Dynamic File Selection
| Command | What It Does |
|---|---|
# GetPlay [+vol] /path/%D_%H.ext | Resolves %D (date) and %H (hour) tokens in the filename, then plays the resulting file. |
# GetFile [+vol] /path/%D_%H.ext | Same as GetPlay but queues the file rather than playing it immediately. |
Commercial Breaks
| Command | What It Does |
|---|---|
# Break :MM:SS | Inserts a commercial break of the specified duration using spots from the imported traffic log for the current hour. |
Voice Tracks
| Command | What It Does |
|---|---|
# VT | Plays the next voice track in rotation with no music bed. |
# VT attribute value | Plays the next voice track in rotation, using a talkbed selected from library files where the specified attribute matches the specified value. Example: # VT Comment TalkBed |
Silence Sensor
| Command | What It Does |
|---|---|
# SS On | Re-enables the silence sensor at this point in the log. |
# SS Off | Disables the silence sensor at this point in the log. Use before intentionally silent segments. |
Display & Announcements
| Command | What It Does |
|---|---|
# ShowText /path/file.txt | Loads a text or RTF file into the Message Pad. RTF formatting is preserved. |
# Overlay [*:]HH:MM:SS attr val [Duck N] | At the specified time, plays a library file matching the attribute/value pair on a separate channel over program audio. *: matches any hour. Optional Duck N ducks main audio by N%. |
# TimeAnnounce [/path/] | Plays a pre-recorded time announcement WAV file named in HHMM format for the current time. |
# TempAnnounce | Plays a pre-recorded temperature announcement using current NWS weather data. |
System
| Command | What It Does |
|---|---|
# Run /path/to/script [&] | Executes an external application or shell script. Add & to run in background (non-blocking). |
Hardware Switcher (requires Broadcast Tools switcher)
| Command | What It Does |
|---|---|
# Switcher HH:MM:SS X-Y [Label] | Routes audio through the switcher for the specified duration. Holds automation until the event ends. Multiple routes: X-Y,A-B. Use X-0 to route to all outputs. |
# Route-On X-Y | Activates a routing immediately with no automatic timeout. Automation continues. |
# Route-Off X-Y | Deactivates the specified routing. Automation continues. |
# ClearSwitcher | Mutes all active routing and restores the reserved channel. |
# SendRelay N | Fires a momentary pulse on relay N (1–8). |
This page is designed to be printed and kept at the console for quick reference. In most browsers, File → Print or ⌘P will print just the content area.