From be7e588c3aab6f0860a02afc7be6ad58386efbc6 Mon Sep 17 00:00:00 2001 From: Jean-Pierre Martineau Date: Thu, 17 Sep 2026 18:38:28 -0400 Subject: [PATCH] A Mac user is told to curl the download, not to fight Gatekeeper The quarantine flag that stops an unsigned binary is set by the browser that downloaded it, not by macOS. curl sets nothing, so the same file fetched that way simply runs -- no dialog, no xattr, no signature. For a program whose users are already at a terminal that is the normal way to install it, so it leads the note now. The old advice was also going stale: Sequoia removed the right-click -> Open bypass, and since Catalina a quarantined binary started from Terminal -- which is how the README says to start MeshTerm -- gets the same block rather than escaping it. Both are named, xattr stays for anyone who already used a browser, and pipx is pointed at as the route that downloads no binary at all. Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index fd74c3c..e01fe2e 100644 --- a/README.md +++ b/README.md @@ -85,6 +85,9 @@ chmod +x meshterm-0.3.6-* ./meshterm-0.3.6-* ``` +On macOS, downloading it with `curl` instead of a browser saves you a fight with Gatekeeper +— the note below has the line. + ### A word about terminals, on Windows MeshTerm is drawn with emoji icons, braille charts and powerline path chips. Whether you @@ -119,8 +122,19 @@ becomes just `meshterm` from anywhere. > code-signed — signing costs real money on both platforms and this is a free side > project. > -> - **macOS**: *"cannot be opened because the developer cannot be verified"*. Clear it with -> `xattr -d com.apple.quarantine meshterm-0.3.6-*` and run it again. +> - **macOS**: *"cannot be opened because the developer cannot be verified"* — or, on Sequoia +> and later, *"Apple could not verify…"*, and right-click → Open no longer gets past it. +> The flag that causes it is set by your **browser**, not by macOS, so the easiest answer +> is to not use one: +> +> ```bash +> curl -L -O https://github.com/jpmartineau/MeshTerm/releases/download/v0.3.6/meshterm-0.3.6-macos-arm64 +> chmod +x meshterm-0.3.6-macos-arm64 && ./meshterm-0.3.6-macos-arm64 +> ``` +> +> `curl` marks nothing, so it simply runs — on an Intel Mac, swap `arm64` for `x64`. If it's +> already downloaded, clear the flag instead: `xattr -d com.apple.quarantine meshterm-0.3.6-*`. +> Installing with pipx (below) avoids all of this too, since nothing is downloaded as a binary. > - **Windows**: *"Windows protected your PC"*. Click **More info → Run anyway**. > > Every release ships a `SHA256SUMS` file if you'd rather check the download first.