Timeframe clock updater (Mac)
=============================

1. Plug the clock into this Mac with a USB cable.
   (Many charging cables carry power only. If it isn't found, try another.)

2. RIGHT-CLICK on:  Update my Timeframe clock
   Choose "Open" from the menu, then "Open" again in the box that appears.

   Right-click, not double-click, and only the first time. macOS blocks
   anything downloaded from the internet unless you open it this way once.

   If that doesn't work, don't fight it - see "If macOS won't open it"
   below. There is a way in that macOS never blocks, and it is two steps.

3. Follow what it says. It takes about a minute.

At the end it shows your clock's SERIAL NUMBER and writes it to
"Clock serial number.txt" next to these files. Send that to Lachlan - it is
the only thing he needs from you to finish setting the clock up.

That's all. It works out which clock you have by itself - including the
oldest ones, which run different software - installs the new version, and
tells you what to do next.


If macOS won't open it
----------------------
Recent versions of macOS have tightened this up, and on some of them
right-click > Open no longer gets you through at all. Don't keep trying it.

There is a way in that macOS never blocks. It takes two steps and it is not
as technical as it looks:

  1. Open the Terminal app. (Press Cmd+Space, type "terminal", press
     Return.) A window with text in it appears.

  2. Type these five characters, INCLUDING the space at the end:

         bash

     Then drag "Update my Timeframe clock" from the Finder window straight
     into the Terminal window and let go. The rest of the line fills itself
     in. Press Return.

That's it - the updater starts, in that window, and behaves exactly as it
would have. It works because you are handing the file to a program you
opened yourself, rather than asking macOS to open it for you.

Do the same with "Check my clock (no changes)" first if you'd rather see it
work before it writes anything.

(You may have been told to look for an "Open Anyway" button in System
Settings > Privacy & Security. That button only appears in the minutes
after macOS has just refused the file, and not on every version, which is
why it may not be there. The Terminal route above always works.)

Nothing is changed on the clock until it has said "Installing the new
software", so anything that goes wrong before then has changed nothing.


If you want to check things first
---------------------------------
Right-click "Check my clock (no changes)" and choose Open. It finds the
clock, tells you which one it is, and changes nothing at all. Doing this
first is a good idea: it gets the macOS permission question out of the way
while the clock is in no danger.


If something goes wrong
-----------------------
The updater writes Timeframe-update-log.txt next to these files. Send that to
Lachlan and he'll know exactly what happened.

If it ever tells you to leave the clock plugged in, please do - it is much
easier to finish an interrupted update than to recover one that lost power
half way.
