Skip to content

Commit e6a58ee

Browse files
Tom Schoenclaude
authored andcommitted
docs: one copy-paste line for first launch (+ drag fallback)
Lead the first-launch step with a single paste-into-Terminal line that finds the freshly-unzipped folder in Downloads and runs the setup, with the drag-the-.command method kept as a fallback for other locations. Closest thing to the 'one button' the operator wanted, given macOS strips the run-flag from ZIP downloads. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 418cc3d commit e6a58ee

1 file changed

Lines changed: 15 additions & 4 deletions

File tree

README.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -64,11 +64,22 @@ setup, then a double-click forever after.
6464
6565
### ① First launch — once (~2 min)
6666

67-
1. **Download & unzip.** On the [repo page](https://github.com/SchoenTom/volscope): **Code ▸ Download ZIP**, then double-click the downloaded ZIP to unzip it.
67+
1. **Download & unzip.** On the [repo page](https://github.com/SchoenTom/volscope): **Code ▸ Download ZIP**, then double-click the downloaded ZIP to unzip it (it lands in your **Downloads** folder).
6868
2. **Open Terminal.** Press **⌘ + Space**, type `Terminal`, press **Enter**.
69-
3. In the Terminal window type **`bash `** (the word *bash* followed by one space) — then **drag the `Start VolScope.command` file** from the unzipped folder onto the Terminal window. Its full location fills in for you.
70-
4. Press **Enter**. VolScope installs its environment, fetches a starter
71-
universe, and opens. ☕ (~2 minutes — only this first time.)
69+
3. **Copy this one line, paste it into Terminal, press Enter:**
70+
```bash
71+
cd "$(ls -dt ~/Downloads/volscope-*/ 2>/dev/null | head -1)" && bash "Start VolScope.command"
72+
```
73+
That installs VolScope's private environment, fetches a starter universe, and
74+
opens it. ☕ (~2 minutes — only this first time.)
75+
76+
<details>
77+
<summary>Unzipped somewhere other than Downloads? (click)</summary>
78+
79+
In Terminal, type **`bash `** (the word *bash* and one space), then **drag the
80+
`Start VolScope.command` file** from your unzipped folder onto the Terminal
81+
window — its location fills in for you — and press **Enter**.
82+
</details>
7283

7384
### ② Every time after that
7485

0 commit comments

Comments
 (0)