Skip to content

Commit 647102a

Browse files
authored
fix: add quarantine removal instructions to release workflow (#34)
macOS Gatekeeper blocks ad-hoc signed apps downloaded from the internet. Added clear instructions for users to run xattr -cr before launching.
1 parent d3f38a3 commit 647102a

1 file changed

Lines changed: 11 additions & 2 deletions

File tree

.github/workflows/release.yml

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -79,8 +79,17 @@ jobs:
7979
8080
1. Download `VocaMac-${{ steps.version.outputs.VERSION }}-arm64.dmg`
8181
2. Open the DMG and drag VocaMac to Applications
82-
3. Open VocaMac from Applications
83-
4. Grant Microphone, Accessibility, and Input Monitoring permissions when prompted
82+
3. **Important:** Remove the quarantine attribute before launching:
83+
```bash
84+
xattr -cr /Applications/VocaMac.app
85+
```
86+
4. Open VocaMac from Applications
87+
5. Grant Microphone, Accessibility, and Input Monitoring permissions when prompted
88+
89+
> **Why step 3?** macOS Gatekeeper blocks apps that aren't notarized with Apple.
90+
> Since VocaMac is ad-hoc signed (no Apple Developer certificate yet), you need to
91+
> clear the quarantine flag manually. This is safe - you can verify the checksums below.
92+
> Proper code signing and notarization is planned for a future release.
8493
8594
### Checksums (SHA-256)
8695
See `checksums.txt` for verification.

0 commit comments

Comments
 (0)