Getting Started
macOS: allow Bypass
First-launch Gatekeeper steps for the Mac build (ad-hoc signed, not notarized).
The macOS build is ad-hoc signed (no Apple Developer ID / notarization — same class of approach as many indie tools). Browser downloads always get a quarantine flag; the DMG includes Install Bypass so you do not have to fight Gatekeeper by hand.
Recommended install (no Gatekeeper loop)
- Download the latest macOS
.dmgfrom Dashboard → Download - Open the disk image
- Double-click Install Bypass (allow Terminal if macOS asks)
- Bypass is copied to Applications, quarantine is cleared, and the app launches
That is the Refract-style path without paying Apple for notarization: clear quarantine on install so Gatekeeper never blocks the installed copy.
Drag-and-drop (optional)
You can still drag Bypass to Applications yourself. If macOS then says Apple could not verify the developer:
- Click Done
- System Settings → Privacy & Security → Open Anyway
- Open Bypass again from Applications (Open Anyway only unlocks the next launch — it does not start the app by itself)
True "opens like App Store apps"
That requires an Apple Developer ID and notarization ($99/year). Without it, Safari/Chrome will always quarantine the download. Install Bypass is the workaround.
Old "damaged" builds
Trash old DMGs/apps and use 0.1.222+ with Install Bypass.