Table of Contents

OnAirScreen: Make OnAirScreen Application executable under macOS

When you download OnAirScreen as a `.dmg` from the internet (AstraStudio Customer Portal, our online shop), macOS marks the app with a quarantine flag. Gatekeeper then blocks the app on first launch — often with a message like *"OnAirScreen can't be opened because Apple cannot check it for malicious software"* or *"the developer cannot be verified"*.

OnAirScreen is not signed with an Apple Developer ID certificate, so macOS treats every downloaded copy as untrusted until you explicitly allow it.

Why is this necessary?

This is normal for unsigned open-source macOS apps — not a sign that OnAirScreen is broken.

Remove the quarantine flag

Option A — Terminal (recommended)

Open Terminal (Applications → Utilities → Terminal) and run:

sudo xattr -d com.apple.quarantine /Applications/OnAirScreen.app

Enter your Mac password (nothing appears while typing — that is normal).

Then start OnAirScreen from Applications or Launchpad.

Option B — Finder (without Terminal)

  1. Drag OnAirScreen.app from the DMG to Applications
  2. Right-click (or Control-click) OnAirScreen.app → Open
  3. In the dialog, click Open again to confirm
  4. macOS remembers this choice for future launches

Verify (optional)

Check whether the quarantine flag is still set:

xattr -l /Applications/OnAirScreen.app

If removal worked, com.apple.quarantine should not appear in the output.

Troubleshooting

"No such xattr: com.apple.quarantine" The flag is already removed — try launching the app normally.

"Operation not permitted"

App still won't start

Only remove the quarantine flag for OnAirScreen copies you obtained from a trusted source (official website or your own CI build).