Settings Reference
The Settings window is where AutoCast learns about your station — your audio hardware, your ZIP code, how you want crossfades to sound, when to send alerts, and much more. Open it from the Settings button in the main interface or with ⌘,.
Settings are organized into tabs. Make your changes, then click Save at the bottom of the window for them to take effect. The Reset Defaults button restores every field to factory values without saving — handy if you've made a mess of the settings and want to start over.
AutoCast stores all settings in a file at Misc/System/Settings/AutoCast.json in your Station Folder. This means your settings travel with your Station Folder — back it up, and your settings are backed up too.
System Tab
| Setting | What It Does |
|---|---|
| Station Folder Path | Displays the current Station Folder location. Click Change… to move it. Changing this setting affects all TuneTracker apps immediately — they all share this path. |
| Primary Output Device | The main audio output — whatever connects to your station's audio chain and goes to air. Select from all macOS audio output devices detected on your system. |
| Preview Output Device | A separate output for auditioning music and watching AutoVision videos without putting anything on air. Typically headphones or a monitor speaker. If you only have one audio output, you can leave this blank — preview features just won't be available separately. |
| Primary Input Device | The live microphone or board input used for live breaks. Select from all macOS audio input devices on your system. |
| Master Volume Boost | A global output trim in dB applied to all program audio. Default is 0.0 dB (no change). Use this to compensate if your audio chain is consistently too quiet or too loud at AutoCast's normal output level. |
| Reboot Recovery | When enabled, AutoCast attempts to resume playback from where it left off after an unexpected shutdown or reboot. Highly recommended for unattended operation. AutoCast saves its position periodically and uses that saved position to restart. |
| Movie Credits Mode | When enabled, the program log scrolls continuously upward — like film credits — rather than jumping to the current item. Some operators find continuous scrolling easier to read; others prefer the jump. Personal preference. |
| Show Skipped Events | When enabled, items that were skipped by a Time-Correct or Interrupt command remain visible in the program log, shown dimmed. When disabled, skipped items are removed from the display. Useful for seeing what the timing adjustments are doing. |
| Auto-Login Warning | Warns you at startup if macOS isn't configured for automatic login — which is required for unattended overnight operation. Leave this on unless you've consciously decided not to use auto-login. |
Audio Tab
These settings control the timing of audio transitions. All values are in seconds unless noted. Getting these right is what makes the difference between transitions that sound natural and ones that feel awkward.
| Setting | Default | What It Controls |
|---|---|---|
| Universal Overlap | 1.0 sec | How early the next song's cue point fires relative to the current song's EOM point, when no specific EOM has been set. Songs without EOM points in the library use this as the crossfade trigger. Increase for tighter transitions; decrease for more breathing room between songs. |
| EOM Fade Duration | 3.0 sec | The crossfade length at EOM transitions. The outgoing song fades out over this duration while the incoming song fades in. 3 seconds is a natural-sounding crossfade for most music styles. |
| Default Interrupt Fade | 5.0 sec | How long it takes to fade out currently playing audio when a # Interrupt command fires. Individual Interrupt commands can override this with their own fade duration. |
| Live Input Fade Out | 1.5 sec | How quickly the live input fades out when a live break ends and automation resumes. A fast fade (0.5–1.0 sec) feels punchy; a slower fade (2–3 sec) feels more gradual. |
| Overlay Duck Fade | 0.3 sec | How quickly the main program audio ducks when an # Overlay command fires. A fast duck (0.1–0.3 sec) is barely noticeable; it's usually the right choice for legal IDs and brief overlays. |
| Master Volume Boost | 0.0 dB | Also accessible here — same as the Master Volume Boost on the System tab. |
Voice Track Tab
| Setting | Default | What It Controls |
|---|---|---|
| Ducking Level | 50% | How much the talkbed is reduced in volume while the voice track plays. 50% = half volume. Lower values keep more music presence underneath the DJ; higher values push the music further back. |
| Talkbed Crossfade | 3.0 sec | The fade duration when the talkbed transitions in or out during a voice track sequence. |
| Fade Up Duration | 1.0 sec | How long it takes the music to return to full volume after the voice track ends. |
| Fade Up Early | 0.75 sec | How many seconds before the voice track ends to begin fading the music back up. This creates the natural "music rising under the last words" effect. A little early is almost always better than exactly at the end. |
| No-Ramp Talkbed Fade | 2.0 sec | The fade duration used when a talkbed file has no Ramp point set in the music library. This is the fallback for talkbeds that haven't been fully configured in Librarian. |
Silence Sensor Tab
The Silence Sensor monitors your main program audio output. If it detects sustained silence — a sign something has gone wrong — it triggers a recovery action and sends an alert. For an unmanned station, this is your safety net.
| Setting | Default | What It Controls |
|---|---|---|
| Enable Silence Sensor | On | Master toggle. Leave this on for unattended operation. Turn it off temporarily if you need to run a silent period intentionally (or use # SS Off in the program log for a more targeted approach). |
| Duration | 10.0 sec | How many consecutive seconds of silence must occur before the sensor fires. 10 seconds catches real problems quickly without being triggered by brief pauses in content. Adjust if your programming includes legitimate silent passages. |
| Level | -40.0 dBFS | The audio threshold below which audio is considered "silent." -40 dBFS is typical. If your content includes very quiet passages (soft ballads, quiet spoken word), you may need to lower this threshold to avoid false triggers. |
Weather Tab
| Setting | What It Does |
|---|---|
| ZIP Code | Your station's ZIP code. Used to locate the nearest National Weather Service observation station. Change this to your actual location — the default (54153) is TuneTracker's home ZIP code in Marinette, Wisconsin, which is probably not your station. |
| Temperature Unit | Fahrenheit or Celsius. Affects both the WeatherPad display and the # TempAnnounce command. |
Backgrounds Tab
| Setting | What It Does |
|---|---|
| Time of Day Backgrounds | When enabled, AutoCast automatically changes its background image based on the current season and time of day. Requires appropriately named image files in Misc/System/Wallpaper/TimeofDay/. See Weather & Announcements for filename conventions. |
| Weather Condition Backgrounds | When enabled (requires Time of Day Backgrounds to also be enabled), AutoCast uses weather-specific background images during precipitation. When the precipitation stops, it reverts to the standard time-of-day image. |
Streaming Tab
See Streaming & Now Playing for full coverage of these settings. In brief:
| Setting | What It Does |
|---|---|
| Feed Audio to SignalCaster | Enables the TCP audio feed to SignalCaster for internet streaming. |
| Port | TCP port for the SignalCaster connection (default 9170). |
| Enable Now Playing File | Writes current song metadata to Misc/System/current_song.txt on each new song. |
| Field 1–4 | Which library fields to include in the Now Playing file. |
| Separator | How fields are separated in the Now Playing file. |
TuneBacker Tab
TuneBacker is an optional add-on application that performs automated backups of your Station Folder. If you have TuneBacker installed, configure it here:
| Setting | What It Does |
|---|---|
| Enable Backups | Activates TuneBacker's backup schedule. |
| Destination Folder | Where backups are copied — any local or network-mounted volume accessible from your Mac. |
| Schedule | How often to back up: Hourly or Daily. |
If you don't have TuneBacker installed, this tab is still visible but the settings have no effect. TuneBacker is available separately from TuneTracker Systems.
Alerts Tab
AutoCast can send email alerts via your Mac's Mail app when significant problems occur. This is invaluable for unmanned overnight operation — if something goes wrong at 2am, you can get an email on your phone rather than discovering the problem at 6am.
| Setting | Default | What It Does |
|---|---|---|
| Alerts Enabled | Off | Master toggle for all email alerts. |
| Email Address | — | Where alert emails are sent. This can be a personal email address, a group address, or a text-to-email address if you want SMS alerts. |
| Automation Unresponsive | On | Alert when the playback engine stops responding. |
| Silence Sensor | On | Alert when the silence sensor triggers. |
| No Program Log | On | Alert when no program log is found for the current hour. |
| Network Error | On | Alert when a network-dependent feature (weather, streaming) fails. |
| Reboot Recovery | On | Alert when AutoCast recovers from an unexpected shutdown — so you know the reboot happened and can investigate the cause. |
A Send Test button lets you verify that Mail.app integration is working before you rely on it. Always use it after configuring alerts — finding out the alerts don't work during an actual emergency is not ideal.
Alerts are sent through Mail.app using AppleScript. Mail.app must be configured with a sending account on your Mac for alerts to work. A 10-minute cooldown per alert category prevents your inbox from being flooded during a cascading failure — you'll get one alert, fix the problem, and not receive 50 more while you're working on it.
Switcher Configuration
Settings for the optional Broadcast Tools audio switcher integration. See Hardware Switchers for complete configuration instructions.
Next up: Keeping AutoCast Running →