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 [[input=label]] [label] | Opens live input for the specified duration, then closes it automatically. Optional volume adjustment in dB. Optional [input=…] token routes the break through a named Input Source ButtonPad button. Optional trailing label shown on deck. |
# 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. |
Segments (DayTracker integration)
The # Marker On and # Marker Off commands in a program
log tell AutoCast to send a message to the DayTracker audio logger the moment
AutoCast rolls across the command. DayTracker adds those start/end markers to
its display of the daily audio log, and can then save out the segment of the
audio log between any matched pair as a separate audio file — one per marked
time period, or all the segments combined into a single audio file. Marking
the day's audio log like that lets you save specific portions for review, or
for replay at a future time. See DayTracker's User's Guide for more on what
it does with the markers it receives.
| Command | What It Does |
# Marker On [label] | Sends a segment-start marker to DayTracker at the instant AutoCast crosses this line. No audio effect, no airtime. Optional trailing text becomes the segment label and is used by DayTracker on its swim-lane display and in any excerpt filename. Example: # Marker On morning_show. |
# Marker Off [label] | Sends a segment-end marker to DayTracker, pairing with the most recent # Marker On to define the segment span. Optional label, same handling as # Marker On. |
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.