adrianbonpin/gridline
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs: use sudo for the quarantine-removal command everywhere (#20)

Browse Source 
The bundle contains read-only files (e.g. the bundled OpenSSL dylibs), so a
sudo-less 'xattr -dr com.apple.quarantine' fails with Permission denied for
some users. Standardize on 'sudo xattr -dr com.apple.quarantine' in the
README, ROADMAP, the release.yml SIGNING STATUS comment, and the release
notes; AGENTS.md now requires release notes to carry the macOS first-launch
instructions until a Developer ID cert is secured.
This commit is contained in:
adrianbonpin
2026-08-08 14:04:25 +08:00
committed by GitHub
parent 38de9b4da1
commit 5bc31a14a6
4 changed files with 5 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+2 -2
View File
@@ -301,10 +301,10 @@ Gridline is currently distributed **unsigned** — it doesn't pay for code-signi
- **macOS — "Gridline is damaged and can't be opened":** remove the quarantine flag macOS attaches to downloaded apps, then launch normally:
```bash
xattr -dr com.apple.quarantine /Applications/Gridline.app
sudo xattr -dr com.apple.quarantine /Applications/Gridline.app
```
You need to re-run this after **every upgrade** (each freshly-downloaded copy gets re-quarantined).
(`sudo` is required — some files inside the bundle are read-only, so removing the flag needs admin rights.) Re-run after **every upgrade** — each freshly-downloaded copy gets re-quarantined.
- **Windows:** on the SmartScreen prompt, click **More info** → **Run anyway**.
- **Linux:** no warning — install and run normally.