Concepts & signal flow · software
Apple macOS troubleshooting
The Apple macOS problems live-event techs bring to Ask Roadie most (also called Mac OS, MacBook show machine, macOS troubleshooting). Pick your symptom, or describe your own in plain words, and get the likeliest fix first, with the manual page when there is one.
Common macOS errors & problems
What techs run into most, and what's usually behind it. The step-by-step fix for your exact software is in Ask Roadie.
- Step-by-step fixGet the fix →
Audio dropouts, clicks, or noise when using an Aggregate Device
Likely cause: Aggregate devices combine hardware with independent clocks; without a defined master and drift correction the sample clocks slip, producing periodic clicks/dropouts.
- Step-by-step fixGet the fix →
External USB/Thunderbolt audio interface not recognized, grayed out, or shows wrong I/O count
Likely cause: A device visible in System Information but grayed in Audio MIDI Setup is a driver/communication problem, not a cable problem — reinstalling the current driver restores full I/O.
- Step-by-step fixGet the fix →
HDMI/USB-C output drops out intermittently or flickers on a MacBook feeding a projector or switcher
Likely cause: Intermittent loss on USB-C Macs is almost always a marginal adapter, cable, or power condition.
- Step-by-step fixGet the fix →
How to update macOS / what is the current version
Likely cause: Software Update is the supported path (it stages and verifies the installer).
- Step-by-step fixGet the fix →
macOS wants to auto-update mid-run / a show machine got silently upgraded and broke a show app
Likely cause: Automatic updates can reboot the machine, change audio/video drivers, or break un-updated show software at the worst time.
- Step-by-step fixGet the fix →
Notification banners or Focus/Do Not Disturb alerts pop up on the projected image during a show
Likely cause: Notification banners render on top of full-screen playback and land on the audience-facing output.
- Step-by-step fixGet the fix →
Playback stutters or cues fire late intermittently for no obvious reason
Likely cause: Spotlight periodically re-indexes attached disks; that momentary disk contention starves audio/video buffers and causes stutter or late cues.
- Step-by-step fixGet the fix →
Projector/external display connected but shows "No Signal" or a black screen
Likely cause: Detect Displays forces a fresh EDID handshake.
- Step-by-step fixGet the fix →
Show app (QLab, ProPresenter, etc.) will not launch: "cannot be opened because the developer cannot be verified" (Gatekeeper)
Likely cause: Gatekeeper blocks the first double-click of an unnotarized/quarantined app.
- Step-by-step fixGet the fix →
Show machine sleeps, dims, or the screensaver kicks in mid-cue
Likely cause: pmset sets the power-management assertions to never sleep the display, disk, or system.
Not on the list? Describe it your way, or paste the error code off the display. Ask Roadie works the problem with you until it's fixed or you have a clear next move.
How Ask Roadie helps with the macOS
- 1. Pick the Apple macOS. It's already in the list.
- 2. Describe what you're seeing. In your own words, or the error code off the screen.
- 3. Get the likeliest fix first. Steps in order, the manual page when there is one, and a note when other techs have confirmed it.
- 4. Still broken? Tap 👎 and it keeps going from where you left off.