Files

4.7 KiB
Raw Permalink Blame History

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.