Files

107 lines
4.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Trying Routine on a Mac: a checklist
Thank you for trying it! Routine has never run on a real Mac before, so every answer helps, "it
worked" included. It takes about 20 minutes, most of it the download. Nothing here touches anything
else on your Mac, and step 9 removes it all again if you like.
You need macOS 13 (Ventura) or newer: Apple menu → About This Mac. Write down the macOS version and
whether it says "Chip: Apple M…" or "Processor: Intel…".
For each step, note **yes / no**, and for any "no", what you saw (a screenshot is perfect: ⇧⌘4,
then drag over it; it lands on the Desktop).
## 1. Install
1. Open **Terminal** (⌘ Space, type `Terminal`, Return).
2. Paste this line and press Return:
```
curl -fsSL https://git.autonomic.zone/trav/routine/raw/branch/main/install-mac.sh | bash
```
3. Wait until it says **Routine … is installed**. It downloads about 400 MB.
- [ ] It finished without an error. (If not: copy everything in the Terminal window, ⌘A then ⌘C,
and paste it into your message.)
- [ ] Did macOS ask you anything while it ran (a password, "allow access", a developer tools
install)? It shouldn't. If it did, what exactly?
## 2. Open it
1. Open **Launchpad** (or ⌘ Space, type `Routine`) and click **Routine**.
- [ ] It opened, the first time. (If macOS said it "can't be opened" or "can't be checked for
malicious software", say so, word for word.)
- [ ] The icon in Launchpad and in the Dock is a ticked box with a few sparks, not a blank page
or a rocket.
- [ ] The menu bar at the top of the screen says **Routine** next to the Apple, not "Python".
- [ ] Hover over its Dock icon: it says **Routine**.
- [ ] There's only one Routine icon in the Dock (not one Routine and one Python).
## 3. The window
- [ ] The window has the normal Mac title bar with the red / yellow / green buttons.
- [ ] You can move it by its title bar and resize it from its edges and corners.
- [ ] The date at the top is in a clean, geometric font (not Times or a typewriter font), and the
task names are easy to read.
- [ ] The word **notes** above the box at the bottom is handwritten-looking.
- [ ] Nothing looks blurry (text, boxes, the » button).
- [ ] Turn your Mac to Dark mode (System Settings → Appearance → Dark): Routine turns dark too
(maybe after reopening it). Back to Light afterwards if you like.
## 4. Ticking
1. Tick a few tasks.
- [ ] A little animation plays from the box, **with a sound**. (Volume up! Each tick has its own.)
- [ ] Tick 6 or more: still animations and sounds.
- [ ] Untick one in **All** (bottom left), and click **skip** on another: both work.
- [ ] Write something in the box at the bottom, click a task, quit Routine (⌘Q), open it again:
the note is still there.
## 5. Moving around
- [ ] Two-finger swipe sideways on the trackpad (or ‹ ›): earlier days. » brings you back to now.
- [ ] Scrolling up and down the list is smooth.
- [ ] Click a block's heading (e.g. **Morning**): its tasks hide; click again: back.
## 6. The menus and shortcuts
- [ ] **Routine** menu (top left, next to the Apple) has **About Routine**, **Settings…** (⌘,) and
**Quit Routine** (⌘Q). All three work.
- [ ] **View → History** (⌘Y), **Statistics** (⌘T) and **Journal** (⌘J) each open a window.
- [ ] ⌘H hides Routine (as in any Mac app).
- [ ] **Help → Open log folder** opens a Finder window (it may be empty: that's good).
## 7. History, Statistics, Journal
1. Open **View → History**.
- [ ] Pinch on the trackpad: it zooms in and out around your fingers. ⌘ + scroll does too.
- [ ] Hover a dot: a tip says which task and day.
- [ ] **Statistics** and **Journal** show your ticks and today's note.
## 8. Settings
1. Open Settings (⌘,).
- [ ] **Routine**: add a task to a block, **Save routine**: it shows up in the main window.
- [ ] **Appearance**: drag a gray slider: the window changes colour as you drag.
- [ ] **Data**: shows two paths under `…/Library/Application Support/Routine`.
- [ ] **Sync** and **Rabbit R1** say **Coming soon on macOS.** and are greyed out.
## 9. Update and remove (optional)
- [ ] Run the install line from step 1 again: it finishes, Routine opens with your ticks and
routine still there.
- [ ] To remove it: paste
`curl -fsSL https://git.autonomic.zone/trav/routine/raw/branch/main/install-mac.sh | bash -s -- --uninstall`.
Routine is gone from Applications. (Your ticks stay in
`~/Library/Application Support/Routine` unless you delete that folder.)
## Sending it back
Your yes / no list, the macOS version and chip, and any screenshots. If anything went wrong, also
the files in **Help → Open log folder** (`errors.log`, `crash.log`, `launch.log`): they hold only
where the program went wrong, never your tasks or notes.