Installation and Gatekeeper
Drag TRAKCAST from the DMG to Applications, attempt to open it, then use System Settings → Privacy & Security → Open Anyway. Approve microphone permission. Do not disable Gatekeeper globally.
Audio device scanning
Connect or start the physical or virtual audio device before scanning. If it is missing, confirm macOS microphone access, reopen the device’s control software, rescan, and verify the selected sample rate.
Shoutcast v1 connection
Use only credentials for a station you are authorized to operate. Enter the host and the provider’s displayed or base port. TRAKCAST derives the required source port for its supported Shoutcast v1 workflow; the port shown in a station dashboard may therefore differ from the source connection port. Confirm the provider’s documentation before broadcasting.
Metadata and artwork
For Serato, provide a reachable public Live Playlist URL and confirm that it shows the current track in a browser. This is URL monitoring, not a native integration. Artwork queries may send Artist/Title to MusicBrainz, Cover Art Archive, and—if configured—Discogs. A Discogs token can improve access and is stored encrypted locally during beta. Missing art falls back to the TRAKCAST placeholder.
OBS overlay setup
Start the local overlay in TRAKCAST, copy its loopback URL, and add it as an OBS Browser Source on the same Mac. The server is intentionally local-only; remote devices cannot load it.
AutoDJ takeover and restoration
Confirm AutoDJ is active before taking the live source. Start the broadcast, verify listener output, and stop through TRAKCAST when finished so the normal restoration path can run. Maintain your station provider’s backup procedure throughout beta.
Diagnostic reports
Use the in-app diagnostic report action, review the generated report, and attach it to an email only after checking it. TRAKCAST redacts recognized credentials and tokens, but you should still inspect the file before sharing.
Quick checks
No input level?
Confirm the device is selected, macOS microphone permission is enabled, the source application is routing audio, and Master Bus is not muted.
Metadata changes but I am offline?
That is expected. Metadata monitoring, history, and the local overlay can operate independently from a live station connection.
Artwork is wrong or unavailable?
Provider matches are best-effort, not guaranteed. Check Artist/Title formatting and Discogs configuration, or accept the placeholder.