Skip to content

Commit d96d803

Browse files
Tom Schoenclaude
authored andcommitted
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>
1 parent fb648f7 commit d96d803

1 file changed

Lines changed: 14 additions & 11 deletions

File tree

README.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -65,27 +65,30 @@ That's it. VolScope builds its private environment (~2 min the first time),
6565
fetches a starter universe, and opens in its own window. **Run the same line
6666
any time** to launch it again.
6767

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.
7272
7373
<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>
7575

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.)*
8085

8186
*Unzipped somewhere other than Downloads?* In Terminal type **`bash `** (with a
8287
space), drag the **`Start VolScope.command`** file onto the window, press Enter.
8388
</details>
8489

8590
*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.*
8691

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.*
88-
8992
<details>
9093
<summary><b>Developer / command-line setup</b></summary>
9194

0 commit comments

Comments
 (0)