Skip to content

Commit d2ec234

Browse files
author
Максим Лясковский
committed
docs: update Gatekeeper bypass instructions for macOS Sequoia
1 parent b826f05 commit d2ec234

1 file changed

Lines changed: 26 additions & 10 deletions

File tree

README.md

Lines changed: 26 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -60,16 +60,32 @@ GitHub Releases ship the `.dmg` exclusively.
6060
- Eject the disk image
6161
- Launch from `/Applications`
6262

63-
**On first launch:**
64-
65-
- The bundle is **unsigned** (no Apple Developer ID). macOS Gatekeeper
66-
may block it the first time — right-click the `.app` in Finder, choose
67-
**Open**, confirm the warning, then launch normally afterwards.
68-
- macOS asks for **local network permission** ("Allow LinkBridge to find
69-
devices on local networks?"). Click **Allow**, otherwise Ableton Link
70-
cannot discover any peers and the tempo stays at the default 120 BPM
71-
forever. The bundle includes a description string explaining what the
72-
permission is used for.
63+
**On first launch (Gatekeeper bypass for unsigned apps):**
64+
65+
The bundle is **unsigned** (no Apple Developer ID), so macOS Gatekeeper
66+
on Sequoia (15+) blocks the first launch with a "could not be opened
67+
because Apple cannot check it for malicious software" dialog. Apple
68+
removed the older right-click → Open shortcut in Sequoia, so the only
69+
way through is via System Settings:
70+
71+
1. Double-click `LinkBridge.app` once. It will be blocked — dismiss
72+
the dialog.
73+
2. Open **System Settings → Privacy & Security**.
74+
3. Scroll down to the **Security** section. You will see
75+
*"LinkBridge was blocked to protect your Mac"* with an
76+
**Open Anyway** button on the right.
77+
4. Click **Open Anyway**, authenticate with Touch ID or your password
78+
if prompted, and confirm the follow-up dialog.
79+
5. LinkBridge launches. Subsequent launches work normally without
80+
any prompts.
81+
82+
**Local network permission:**
83+
84+
Right after the first successful launch, macOS asks *"Allow LinkBridge
85+
to find devices on local networks?"* — click **Allow**. Without this
86+
permission, Ableton Link cannot discover any peers and the menu bar
87+
tempo stays at the default 120 BPM forever. The bundle ships a
88+
description string explaining what the permission is used for.
7389

7490
## Menu reference
7591

0 commit comments

Comments
 (0)