Therbie Help
Get started

Pair your Mac and devices

Pairing links an iPhone or iPad to Therbie on your Mac, so the two can talk over your local network. You pair each device once. After that they connect by themselves whenever both are on the same network with Therbie open.

Once paired, the Mac can:

  • show the device's live readings;
  • start benchmarks, throttle tests and run plans on it;
  • collect the device's data by itself, with no exporting, and change some of it at your request (see below).

The same pairing lets the device show the Mac's status in Mac Display, if the Mac shares it.

Pair a device

  1. On the iPhone or iPad, open Therbie and go to the Mac tab. On the Mac Testing card, turn on Allow my Mac to run tests. Allow Local Network access if iOS asks.
  2. On the Mac, open Therbie and choose Devices. The device appears as Not paired.
  3. On the Mac, click Pair…. The Mac shows a 6-digit code, such as 042 917.
  4. On the device, Therbie asks Pair with "your Mac's name"? and shows a code. If the two codes match, tap Allow.

The device is now Connected.

  • Keep Therbie on screen on the device while you pair. The request only appears there, and it waits about a minute for your answer.
  • Already paired with a Mac of that name? The request says so, and Allow replaces the old pairing.

Important If the codes don't match, tap Don't Allow. A different code means something other than your Mac answered.

Why compare a code?

Anyone on the same network can see that your device is there. Comparing codes makes sure the device is pairing with your Mac and nothing in between. Both screens work out the code on their own, and the codes match only when the two are talking directly. Bluetooth pairing uses the same idea.

After pairing:

  • Only your paired Macs can connect. Other Macs on the network see Not paired and need your tap on the device to pair.
  • Everything is encrypted. Readings, commands, results and data are encrypted between your Mac and the device, with fresh keys each time they connect.
  • The pairing key stays on your devices. Each side keeps it in its Keychain, on that device only. It doesn't sync through iCloud Keychain and doesn't move to a new device when you restore a backup, so a new or restored device has to pair again.

What the Mac collects

While a device is connected, the Mac fetches its data when they connect and again every 15 minutes:

DataWhere it appears on the Mac
Benchmark and throttle resultsRuns & Compare, under the device
History and data usageRuns & Compare › Imported Data, per device
Trips (with their routes), vibration sessions and the sound logSensors
Bluetooth plant sensor readings and Bluetooth survey countsSensors (Plants, Bluetooth)

The device's card on the Devices page says when they last arrived. The Mac keeps this data until you delete it, or for the time set in Therbie › Settings… › Storage › Keep synced data (default Forever).

The Mac only reads what the device has recorded. iOS doesn't let Therbie record while it's paused, so gaps in a device's History stay gaps on the Mac too. See History and Insights.

What the Mac can change

From its Sensors page and device settings, a paired Mac can make changes on the device. They are sent the next time the device connects:

  • rename or delete trips, vibration sessions and plant readings;
  • organise Bluetooth plant sensors and their pots;
  • change some device settings, such as the plant-sensor log interval and the Bluetooth survey.

Remove a pairing

  • On the iPhone or iPad: on the Mac tab, open Paired Macs on the Mac Testing card and tap Remove next to the Mac. If it's connected, it's disconnected.
  • On the Mac: on the device's card, open ⋯ and choose Unpair.

Either way, the two have to pair again before they can connect, and the device's Mac Display stops showing that Mac. Results and data already on the Mac stay there until you delete them.

If pairing doesn't work

  • "Open Therbie on the device to pair." The device was in the background. Bring Therbie to the front and click Pair… again.
  • "A pairing was just declined or not answered on the device. Try again in a moment." After Don't Allow, or a request nobody answered, the device ignores new requests for 30 seconds.
  • "The device didn't answer. Open Therbie on it and try again." The request timed out. Click Pair… again and tap Allow within the minute.
  • "Another Mac is waiting to pair with this device." Answer or let the other request time out first.
  • The device doesn't appear at all: see Troubleshooting.