PulseMesh Timecode Bridge — macOS
=================================

This folder is the whole install. There is no setup program; the bridge
runs from wherever you unzipped it. It is built for Apple silicon Macs
(M1 and later).

Quick start
-----------
1. Double-click pm_gateway. A Terminal window opens and stays open — that
   window IS the bridge. Minimize it, don't close it.

   The download is signed and notarized with Apple, so macOS runs it
   without a warning. The first launch checks the notarization with Apple
   over the internet, so be online the first time you run a new version.
   A SHA-256 hash is published beside the zip if you want to verify the
   download first:

       shasum -a 256 pulsemesh-timecode-bridge-<version>-macos-arm64.zip

2. On the same Mac, open:

       http://127.0.0.1:9130

3. The page shows a short claim code. Claim it on pulsemesh.io (any
   browser, phones included). The bridge finishes pairing by itself.

4. In SkyBrush Server's smpte_timecode config, use
   "pattern": "*PulseMesh*". The bridge creates its own "PulseMesh TC"
   MIDI port every time it starts — nothing to install, nothing to name,
   nothing to keep running.

Microphone prompt
-----------------
If you set the bridge to chase house LTC through an audio input, macOS
asks once whether Terminal may use the microphone. Allow it — that is the
audio input. Generating timecode never triggers the prompt.

Updating
--------
Stop the bridge (close the Terminal window), replace pm_gateway with the
new one, start it again. Your configuration and pairing survive — they
live outside this folder; the page footer shows the exact path and the
running version.

Show-day notes
--------------
- Stop the Mac from sleeping for the show: System Settings -> Energy (or
  Battery on a laptop) -> prevent sleep when the display is off, and keep
  it plugged in. A sleeping Mac is a stopped bridge, and SkyBrush faults
  after 3 seconds of timecode silence.
