FreeCoffee › Dashboard › Install guide

Installing FreeCoffee when Apple blocks it

A plain-English walkthrough for the "Apple could not verify…" message. Works on macOS 13 Ventura and later (including macOS 26). Two minutes, once.

Why this happens: FreeCoffee is an open-source demo app that isn't signed with a paid Apple certificate ($99/yr). macOS shows the same warning for every unsigned app — it does not mean the app has a virus. Our app is a single readable Swift file you can audit in the public repo, and it never reads your screen, files, or keystrokes.

Method 1 — Right-click → Open (easiest)

  1. Open the downloaded FreeCoffee.dmg (double-click it in Downloads).
  2. In the window that appears, drag FreeCoffee into Applications.
  3. Open Applications, right-click (or two-finger click) FreeCoffee → Open.
  4. A dialog appears with the app name — click Open in that dialog. (If you only see "Cancel", see Method 2.)

You only do this once. After that, FreeCoffee opens like any normal app.

Method 2 — "Open Anyway" in System Settings

  1. Double-click FreeCoffee once — the "Apple could not verify" dialog appears. Click Done (not "Move to Bin").
  2. Open System Settings → Privacy & Security (on macOS 12 and earlier: System Preferences → Security & Privacy → General).
  3. Scroll down to the Security section. You'll see: "FreeCoffee was blocked from use because it is not from an identified developer."
  4. Click Open Anyway, authenticate with your password or Touch ID, then click Open in the follow-up dialog.

macOS 26 note: the Open Anyway button can take up to a minute to appear after the block — wait a moment and reopen Settings.

Method 3 — One Terminal command (removes the warning completely)

  1. Install FreeCoffee using Method 1 (drag to Applications).
  2. Open Terminal (Applications → Utilities → Terminal).
  3. Paste this exact line and press Return:
xattr -dr com.apple.quarantine /Applications/FreeCoffee.app

That removes the "downloaded from the internet" flag. FreeCoffee now opens by double-click, forever, with no dialogs.

Zero-warning option — Homebrew

If you use Homebrew, the cask strips the flag automatically — no Terminal, no dialogs, and future updates come through brew upgrade:

brew tap ayodhyamohanthy/freecoffee https://github.com/ayodhyamohanthy/freecoffee-tap
brew install --cask ayodhyamohanthy/freecoffee/freecoffee

Troubleshooting every common message

"FreeCoffee cannot be opened because Apple cannot check it for malicious software."

The standard Gatekeeper block. Use Method 1 or 2 above. If Open Anyway isn't visible yet, wait ~1 minute — macOS populates it after the first block.

"FreeCoffee can't be opened because it is from an unidentified developer."

Same block, older wording (macOS 12 and earlier). Same fix: right-click → Open, or Open Anyway in Security & Privacy.

"FreeCoffee is damaged and can't be opened. You should move it to the Bin."

This appears when the download was interrupted or when macOS added the quarantine flag in a way the app can't read. Two fixes, in order:

  1. Run: xattr -dr com.apple.quarantine /Applications/FreeCoffee.app then open the app again.
  2. If it still fails, re-download the DMG (the file may be truncated) and repeat Method 1.

Verify your download: the DMG should be ≈283 KB (v1.1.0, universal arm64+x86_64 — exact bytes vary per build; if yours is under 100 KB the download was truncated, re-download).

"FreeCoffee will damage your computer" (macOS 26 / Sequoia-era wording).

Same Gatekeeper mechanism, scarier words. Go to System Settings → Privacy & Security → Open Anyway. The wording is generic — it fires for every un-notarized app, not just ours.

Right-click shows no "Open" option at all.

You right-clicked the DMG file instead of the app. Mount the DMG first, drag the app to Applications, then right-click the app in Applications.

The app opens but I don't see it anywhere.

FreeCoffee lives in your menu bar (top-right of the screen) — look for "☕ FreeCoffee". It has no Dock icon or window by design. Click the menu-bar item for the balance popover.

Still stuck?

Email support@freecoffee.tech with a screenshot of the exact message and your macOS version ( → About This Mac). We'll answer with a specific fix.

Never see this again (optional, $99)

The permanent fix is an Apple Developer certificate + notarization — that's what large companies pay for. We chose the free path: the app is fully open-source and auditable. If that ever changes, this page will say so.

Safety note: Never disable Gatekeeper system-wide (spctl --master-disable) or run install scripts that ask you to. The xattr command above targets only the FreeCoffee app — that's the safe, surgical approach.