You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Browse filesBrowse the repository at this point in the historyBrowse files
authored and
Tom Schoen
committed
docs: honest macOS Sequoia note for the icon + drop a duplicate line
The command is the no-friction path (bash bypasses Gatekeeper entirely). The
app-icon bonus now states the truth: on Sequoia the first icon-open shows
'Apple could not verify' (unsigned/un-notarized), cleared once via System
Settings -> Privacy & Security -> Open Anyway. Also removed a duplicated
'Requires Python 3.11+' paragraph.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: README.md
+14-11Lines changed: 14 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -65,27 +65,30 @@ That's it. VolScope builds its private environment (~2 min the first time),
65
65
fetches a starter universe, and opens in its own window. **Run the same line
66
66
any time** to launch it again.
67
67
68
-
> **Why a command, not just a double-click?** macOS strips the "this file may
69
-
> run" flag from *anything* downloaded as a ZIP — a built-in security default,
70
-
> nothing to do with VolScope. The line above launches it the one way that
71
-
> always works, on any Mac.
68
+
> **Why a command, not a double-click?** macOS strips the "may run" flag from
69
+
> anything downloaded as a ZIP, and the newest macOS (Sequoia) blocks unsigned
70
+
> apps launched from Finder. The command sidesteps both — it's the one way that
71
+
> works on every Mac, every time.
72
72
73
73
<details>
74
-
<summary><b>Bonus: launch from the app icon</b> (after the first run)</summary>
74
+
<summary><b>Bonus: launch from the app icon</b></summary>
75
75
76
-
That first run also repairs the **`VolScope.app`** icon (restores the run flag,
77
-
clears the download quarantine, ad-hoc-signs the bundle). So from then on you
78
-
can also just **double-click the VolScope icon** — it opens in a clean window
79
-
with no Terminal. Quit it like any app (**Dock → Quit**) to stop the server.
76
+
The first run repairs the **`VolScope.app`** icon (restores the run flag, clears
77
+
the download quarantine, ad-hoc-signs it), so on most Macs you can then just
78
+
**double-click the VolScope icon** — a clean window, no Terminal.
79
+
80
+
On **macOS Sequoia (15)** the very first icon-open shows *"Apple could not
81
+
verify…"* (the app isn't App-Store-notarized — it's a personal tool). Approve it
82
+
once: **System Settings → Privacy & Security → scroll to "VolScope was blocked"
83
+
→ Open Anyway**. After that, the icon opens normally. *(Don't want the fuss? Just
84
+
keep using the one command above — it never asks.)*
80
85
81
86
*Unzipped somewhere other than Downloads?* In Terminal type **`bash `** (with a
82
87
space), drag the **`Start VolScope.command`** file onto the window, press Enter.
83
88
</details>
84
89
85
90
*Requires **Python 3.11+** on your Mac (free from [python.org](https://www.python.org/downloads/)). VolScope builds its own isolated environment and never touches your system Python. Everything runs locally — no account, no subscription, no data ever leaves your machine.*
86
91
87
-
> *Requires **Python 3.11+** on your Mac (free from [python.org](https://www.python.org/downloads/)). VolScope builds its own isolated environment and never touches your system Python. Everything runs locally — no account, no subscription, no data ever leaves your machine.*
0 commit comments