# Therbie Help: every page
> Therbie shows what an iPhone, iPad or Mac is doing right now: CPU, memory, heat (thermal state), battery and network, with the phone's sensors, benchmarks that test how fast a device stays when it gets hot, widgets, Control Center controls, Siri and Shortcuts, and a floating monitor. Readings are made on the device. See each page for what iOS does and doesn't let an app see.
---
id: index
type: concept
title: Therbie Help
summary: Therbie is a system monitor for iPhone, iPad and Mac. It shows CPU, memory, thermal state, battery, network and storage, runs benchmarks, and adds sensor tools, widgets, Shortcuts actions and a floating monitor.
section: home
url: "https://irrhuh.app/therbie/"
related: [getting-started, dashboard, ios-limits, faq, support]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---

Therbie Help
Therbie shows what your iPhone, iPad and Mac are doing right now: CPU, memory, thermal state, battery, network and storage. It measures how fast a device is and how much speed it keeps when it gets hot. It puts the readings in widgets, Control Center, Shortcuts and a floating window.
## Start here
Getting startedWhat you need, the four tabs, and five things worth setting up.
The dashboard (Device tab)Every card, what its numbers mean, and the ⋯ menu.
Widgets, Lock Screen and StandBySeven widgets, a Control Center control, and what "Updated" means.
Therbie for MacThe menu bar, This Mac, History, Devices and Runs & Compare.
Pair your Mac and devicesCompare a 6-digit code, tap Allow, and the Mac collects each device's data.
Frequently asked questionsBattery use, temperatures, privacy, and what needs a Mac.
## Popular
## What Therbie is, and isn't
Therbie is a system monitor and sensor toolkit for iPhone and iPad (iOS and iPadOS 18 or later). It has a companion app for Mac (macOS 15 or later) and an optional Apple Watch app (watchOS 11 or later).
**What it does:**
- Reads the counters that iOS, iPadOS and macOS make available to every app, and labels them plainly.
- Measures device speed with a one-minute quick benchmark and a 5- or 15-minute throttle test.
- Turns the device's motion sensors, microphone, camera, barometer and GPS into measuring tools. Each one is off until you turn it on. See [Motion instruments](https://irrhuh.app/therbie/guide/sensors-vibration.html), [Sound level](https://irrhuh.app/therbie/guide/sensors-sound.html) and [Location and trips](https://irrhuh.app/therbie/guide/sensors-location.html).
**What it doesn't do:**
- **It doesn't show temperatures or GPU load on iPhone and iPad.** iOS doesn't share them with apps, so Therbie says so instead of guessing. See [What iOS doesn't let apps see](https://irrhuh.app/therbie/kb/ios-limits.html).
- **It doesn't speed up, clean or cool your device.** It only measures.
- **It has no account, no ads and no analytics.**
**Where your data goes:** readings stay on your devices. They are sent only to a Mac you have paired, encrypted, over your own local network. Therbie contacts an internet server only to download public data, and only when you tap a button for it. That means satellite orbits on iPhone and iPad, and public weather data on the Mac. See the [privacy policy](https://irrhuh.app/therbie/privacy.html).
Need help? See [Help and contact](https://irrhuh.app/therbie/support.html).
---
id: getting-started
type: guide
title: Getting started
summary: Therbie needs iOS or iPadOS 18, or macOS 15 for the Mac app. It starts reading as soon as you open it, with no sign-in. This page covers the four tabs and five things worth setting up.
section: start
url: "https://irrhuh.app/therbie/guide/getting-started.html"
related: [dashboard, widgets, floating-monitor, benchmarks, shortcuts-siri, mac-app]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# Getting started
Therbie starts reading your iPhone or iPad's CPU, memory, thermal state and battery as soon as you open it. There's no account to create and nothing to set up first. This page lists what Therbie needs, explains its four tabs, and suggests five things to set up.
## What you need
| Device | Requirement | Notes |
|---|---|---|
| iPhone | iOS 18 or later | The two language-model tests in the quick benchmark need a device with Apple Intelligence turned on. Elsewhere they show **Not available on this device** |
| iPad | iPadOS 18 or later | On wider screens the dashboard spreads into two or three columns |
| Mac | macOS 15 or later | Optional. Shows the Mac's own readings, and collects and compares results from your iPhones and iPads. See [Therbie for Mac](https://irrhuh.app/therbie/guide/mac-app.html) |
| Apple Watch | watchOS 11 or later | Optional, used with the iPhone app: Lap, Mark and Stop for a recording trip, heart rate into the iPhone's trip, and a Logger. This help site doesn't cover the Watch app |
## The four tabs
Therbie on iPhone and iPad has four tabs. On iPad they can also appear as a sidebar.
| Tab | What's on it |
|---|---|
| **Device** | The live dashboard: rings for CPU, memory, thermal state and battery, then a card for each topic. See [The dashboard](https://irrhuh.app/therbie/guide/dashboard.html) |
| **Measure** | A tile for each sensor tool (vibration, sound level, location, barometer and more), and **Start** buttons for trips and sessions. Sensors are off until you turn them on |
| **Sessions** | Everything you've recorded: trips, vibration sessions, lap sessions and sound logs, newest first |
| **Mac** | The **Your Mac** card (see [Mac Display](https://irrhuh.app/therbie/guide/mac-display.html)) and the **Mac Testing** card (see [Testing devices from your Mac](https://irrhuh.app/therbie/guide/device-link.html)) |
The **⋯** (Options) button at the top right of every tab opens the settings menu.
## How often it reads
While Therbie is on screen, the dashboard takes a reading every 5 seconds. You can change this to 2 or 10 seconds in **⋯ › Set refresh frequency**.
- **In Low Power Mode, or when the device is Hot or Critical,** Therbie waits at least 10 seconds between readings to save energy.
- **When you leave Therbie, iOS pauses it,** and the dashboard stops reading. There are exceptions where Therbie keeps running in the background:
- while the [floating monitor](https://irrhuh.app/therbie/guide/floating-monitor.html) is open;
- while a trip is recording;
- while a sensor has **Keep logging in the background** turned on.
Each card has an **ⓘ** button. Tap it for a plain explanation of what the numbers mean and what iOS does and doesn't allow.
## Five things worth setting up
1. **Add a widget.** Touch and hold the Home Screen, tap **Edit › Add Widget**, and search for Therbie. [Widgets, Lock Screen and StandBy](https://irrhuh.app/therbie/guide/widgets.html) describes each one.
2. **Add the Control Center control.** Open Control Center, tap **+**, then **Add a Control**, and choose Therbie. A tap on the control opens Therbie.
3. **Try the floating monitor** before your next game. See [Floating monitor](https://irrhuh.app/therbie/guide/floating-monitor.html).
4. **Run a quick benchmark** while the device is cool, so you have a baseline. See [Benchmarks and throttle tests](https://irrhuh.app/therbie/guide/benchmarks.html).
5. **Put a Therbie action on the Action Button**, on iPhones that have one. See [Shortcuts and Siri](https://irrhuh.app/therbie/guide/shortcuts-siri.html).
**⋯ › Add to Control Center & Widgets** walks you through steps 1 and 2 in the app.
## Using a Mac as well
Install Therbie on a Mac to:
- see the Mac's own readings in the menu bar;
- collect and compare benchmark results and History from all your devices;
- run tests on iPhones and iPads over your local network.
Start with [Therbie for Mac](https://irrhuh.app/therbie/guide/mac-app.html), then [pair your devices](https://irrhuh.app/therbie/guide/pairing.html).
---
id: pairing
type: task
title: Pair your Mac and devices
summary: Pair an iPhone or iPad with Therbie for Mac once. Click Pair… on the Mac, check that the 6-digit codes match, and tap Allow on the device. The Mac can then show its readings, run tests and collect its History and sensor recordings, encrypted, over your local network.
section: start
url: "https://irrhuh.app/therbie/guide/pairing.html"
related: [device-link, mac-display, mac-app, privacy-security, troubleshooting]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# 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](https://irrhuh.app/therbie/guide/mac-display.html), 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 {#history-from-your-devices}
While a device is connected, the Mac fetches its data when they connect and again every 15 minutes:
| Data | Where it appears on the Mac |
|---|---|
| Benchmark and throttle results | **Runs & Compare**, under the device |
| History and data usage | **Runs & Compare › Imported Data**, per device |
| Trips (with their routes), vibration sessions and the sound log | **Sensors** |
| Bluetooth plant sensor readings and Bluetooth survey counts | **Sensors** (**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](https://irrhuh.app/therbie/guide/history-insights.html).
## 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](https://irrhuh.app/therbie/kb/troubleshooting.html#the-mac-doesnt-see-my-iphone-or-ipad).
---
id: dashboard
type: screen
title: The dashboard (Device tab)
summary: The Device tab is Therbie's live dashboard on iPhone and iPad. It has rings for CPU, memory, thermal state and battery, then cards for CPU, memory, thermal state, battery, network, data usage, GPU, storage, History, Insights, the floating monitor and benchmarks.
section: device
url: "https://irrhuh.app/therbie/guide/dashboard.html"
related: [getting-started, memory, thermal-states, battery, data-usage, history-insights, floating-monitor, benchmarks]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
opens_from: [getting-started]
leads_to: [history-insights, floating-monitor, benchmarks, alerts]
---
# The dashboard (Device tab)
The dashboard is the **Device** tab in Therbie on iPhone and iPad. It is one scrolling page that starts with four rings (CPU, memory, thermal state and battery), then has one card per topic, each with a headline number. On iPhone the cards stack in one column. On iPad, or an iPhone in landscape, they spread into two or three columns.
The line at the top shows the device's chip, its model identifier (for example *iPhone18,1*) and its iOS or iPadOS version.
## The ⋯ menu
The **⋯** (Options) button at the top right of every tab holds Therbie's settings:
| Item | What it does |
|---|---|
| **Set refresh frequency** | **Every 2 s**, **Every 5 s** or **Every 10 s**. The default is 5 seconds. 2 seconds is the most responsive; 10 seconds uses the least battery. In Low Power Mode, or when the device is Hot or Critical, Therbie waits at least 10 seconds whatever you choose |
| **Animate readings** | Rings and bars glide to each new reading instead of jumping. On by default on devices with an M-series chip, off by default on devices with an A-series chip. Always off when **Reduce Motion** is on in iOS Settings |
| **Add to Control Center & Widgets** | A short guide to adding the control and the widgets |
| **Sensors** | Every sensor's switch and settings. See the sensor pages, such as [Motion instruments](https://irrhuh.app/therbie/guide/sensors-vibration.html) |
| **Alerts** | Notifications for heat, memory and battery. See [Alerts](https://irrhuh.app/therbie/guide/alerts.html) |
| **Shortcuts & Siri** | What Therbie's Shortcuts actions do, with example automations. See [Shortcuts and Siri](https://irrhuh.app/therbie/guide/shortcuts-siri.html) |
| **Export data** | Shares Therbie's three data files (`history.json`, `benchmarks.json`, `data-usage.json`) through the share sheet, for example to the Mac app. Appears once the files exist, about a minute after first launch |
Animations cost CPU. In the developer's measurements (7 November 2026, at a 2-second refresh), they roughly doubled Therbie's own CPU use on an iPhone 17 Pro and nearly tripled it on two iPads with A-series chips. That's why they're off by default on A-series chips.
## The cards
| Card | Headline | What else it shows |
|---|---|---|
| **Insights** | The most notable thing **Today** | Tap **Show All** for every finding today and this week. See [History and Insights](https://irrhuh.app/therbie/guide/history-insights.html) |
| **CPU** | Total load across all cores | A chart of the last 90 readings and a bar per core |
| **Memory** | Memory in use | App, Wired, Compressed, Cached and Free memory. See [Memory, explained](https://irrhuh.app/therbie/kb/memory.html) |
| **Thermal** | Normal, Warm, Hot or Critical | What the level means for performance. See [Thermal states](https://irrhuh.app/therbie/kb/thermal-states.html) |
| **Battery** | Level and state | Low Power Mode. While charging: the estimated charging speed (for example *+0.8% per min · ≈ 12 W*) and the time to 80% or to full. See [Battery readings](https://irrhuh.app/therbie/kb/battery.html) |
| **Floating Monitor** | Start or stop | See [Floating monitor](https://irrhuh.app/therbie/guide/floating-monitor.html) |
| **History** | Peak CPU over the last 24 hours | Time spent Warm or hotter today. **Show History** opens the charts |
| **Benchmark** | Your last results | **Run tests** opens the Benchmark screen. See [Benchmarks and throttle tests](https://irrhuh.app/therbie/guide/benchmarks.html) |
| **Network** | Download and upload speed | A chart of the last 90 readings |
| **Data Usage** | This billing cycle | Cellular, Wi-Fi and Hotspot totals. See [How data usage is counted](https://irrhuh.app/therbie/kb/data-usage.html) |
| **GPU** | What the GPU is, not how busy it is | **Chip**, **Metal family**, **Memory budget per app**, **Unified memory** and **Hardware ray tracing**. iOS doesn't let App Store apps read GPU load; the card's **ⓘ** says so |
| **Storage** | Space used | Free space as iOS reports it for large downloads |
On iPhone the cards appear in the order above. On iPad the order changes to fill two or three columns.
The **Mac Testing** and **Your Mac** cards are on the **Mac** tab, not the Device tab. Sensor tiles are on the **Measure** tab.
## The ⓘ explainers
Each card's **ⓘ** button opens a short explanation: what's counted, what iOS doesn't allow, and what's normal. A full memory bar, for example, is how iOS is meant to work.
## Battery and charging
iOS gives many devices' apps the battery level only in 5% steps. Therbie marks those readings with **≈**. [Battery readings](https://irrhuh.app/therbie/kb/battery.html) explains why.
- **Charging speed** is estimated from how fast the level rises. Therbie shows it as percent per minute and an approximate wattage.
- **Charging is holding at …%** appears only on devices that report single percents. It shows when the level has stayed the same for 10 minutes while plugged in, at about 80% or above. That's usually the charge limit or Optimised Battery Charging.
- **Charging slowly** appears when the level is below 80% and the estimate is under about 7.5 W. That usually means a low-power charger, a worn cable, or a hot or busy device.
## Data usage
Therbie adds up Wi-Fi and cellular traffic by day and groups it into billing cycles. Set the day your cycle starts in the Data Usage card's **ⓘ** sheet, under **Billing cycle starts on**. Personal Hotspot traffic also passes through cellular, so the **Hotspot** figure is part of the cellular total, not extra. Read [How data usage is counted](https://irrhuh.app/therbie/kb/data-usage.html) before relying on the figures.
---
id: floating-monitor
type: screen
title: Floating monitor
summary: The floating monitor is a small Picture in Picture window that shows live CPU, memory and thermal state over any other app, with a matching Live Activity on the Lock Screen and Dynamic Island. While it's open, Therbie keeps reading every second and saving History.
section: device
url: "https://irrhuh.app/therbie/guide/floating-monitor.html"
related: [alerts, background-limits, history-insights, dashboard]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
opens_from: [dashboard]
---
# Floating monitor
The floating monitor shows a small live window of your iPhone or iPad's readings on top of other apps, for example during a game. It is a Picture in Picture window, the same kind videos use. It also adds a Live Activity to the Lock Screen and, on iPhones that have one, the Dynamic Island.
The window needs Picture in Picture. On a device without it, the card says the floating monitor can't run there.
## Start and stop it
1. Go to the **Device** tab and find the **Floating Monitor** card.
2. Tap **Start floating monitor**.
3. Go to the Home Screen or another app. The window stays.
To stop it, return to Therbie and tap **Stop floating monitor**, or close the window.
**Start automatically when I leave Therbie** is off by default. When it's on, the window opens by itself whenever you go to the Home Screen or switch apps from Therbie, and closes when you come back. Two things to know:
- **iOS can only open the window from a preview that's on screen.** When the Floating Monitor card is scrolled out of view, or you're on another tab, a small live copy docks in the bottom corner. Tap it to open the floating window straight away.
- **The Lock Screen view may not appear** when the window opens by itself, because iOS lets apps start a Live Activity only while they're open. Tap **Start floating monitor** in Therbie to be sure of it.
## Choose what it shows
Under **Show**, pick any of **CPU**, **Memory** and **Thermal**; at least one stays on. The window, the Dynamic Island and the Lock Screen all show the same choice. Battery isn't offered because iOS already shows it in the status bar.
The window stays the same size whatever you choose; fewer readings get wider columns.
## The window
| Action | What happens |
|---|---|
| Pinch, or double-tap | Changes the window's size |
| Drag | Moves it to another corner |
| Drag it off the left or right edge | Tucks it away. It keeps running, and on iPhone the Dynamic Island keeps showing your readings. Swipe to bring it back |
| Close the window | Stops the floating monitor. iOS then pauses Therbie as usual |
## What runs while it's open
While the window is open, iOS keeps Therbie running. Therbie plays no sound and doesn't interrupt your game's audio.
| What | How often |
|---|---|
| Reading, saved to [History](https://irrhuh.app/therbie/guide/history-insights.html) | Every second. Every 5 seconds in Low Power Mode or when the device is Hot or Critical |
| Lock Screen and Dynamic Island (Live Activity) | About every 10 seconds |
| [Alerts](https://irrhuh.app/therbie/guide/alerts.html) | Checked with every reading |
**Battery use:** one reading and one small picture per second. That's a little more than leaving Therbie closed, and far less than the game beside it. Close the window when you're done.
**Lock Screen view:** to turn the Live Activity off, go to **Settings › Therbie** and turn off **Live Activities**. The floating window works without it. iPad has no Dynamic Island, so there the Live Activity appears only on the Lock Screen.
## What it doesn't do
- **It doesn't keep the Mac connected.** Mac Testing and Mac Display close their connection shortly after Therbie leaves the screen, even with the floating window open. The Mac reconnects when you come back to Therbie. See [Testing devices from your Mac](https://irrhuh.app/therbie/guide/device-link.html).
- **It doesn't measure one app.** Readings are for the whole device: iOS doesn't let apps measure other apps one by one.
- **It can't stop iOS closing it.** iOS may close the window, for example when another app opens its own Picture in Picture, or during a call.
---
id: benchmarks
type: guide
title: Benchmarks and throttle tests
summary: Therbie's quick benchmark measures CPU, GPU, on-device AI, memory and storage speed in about a minute. The 5- or 15-minute throttle test shows how much of its peak speed the device keeps once it's hot. A Charger Test times how fast the battery fills.
section: device
url: "https://irrhuh.app/therbie/guide/benchmarks.html"
related: [throttle-test-length, thermal-states, device-link, mac-app, glossary]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Benchmarks and throttle tests
Therbie on iPhone and iPad has two speed tests:
- **Quick benchmark:** how fast the device is right now, in real units such as GFLOPS (billions of calculations per second).
- **Throttle test:** how much of that speed the device keeps once it gets hot.
The Benchmark screen also has a **Charger Test**, which times how fast the battery fills.
To open the Benchmark screen, go to the **Device** tab and tap **Run tests** on the **Benchmark** card.

## Run the quick benchmark
1. Let the device cool down until the **Thermal** card says **Normal**.
2. On the Benchmark screen, tap **Run Benchmark · about 1 min**.
3. Keep Therbie on screen until it finishes. The screen stays on meanwhile. If you leave Therbie, the benchmark stops and its results aren't saved.
It measures eight things:
| Group | Test | Unit |
|---|---|---|
| CPU, one core and all cores | Matrix maths, hashing, compression | GFLOPS, MB/s |
| GPU | 32-bit maths | GFLOPS |
| Neural Engine and AI | Image classification | images/s |
| | Language model, reading a long prompt; language model, writing an answer | tokens/s |
| Memory and storage | Memory copy, storage write, storage read | GB/s, MB/s |
The two language-model tests use Apple's on-device model, so they need Apple Intelligence turned on. Elsewhere they show **Not available on this device**, or ask you to turn on Apple Intelligence.
Results are saved. **Saved Runs** lists every benchmark and throttle test.
## Run a throttle test
The throttle test runs the CPU or the GPU flat out and takes a reading every 10 seconds: speed, thermal state, battery level and whether it's charging. The result is **Kept % of peak**: the average of the last 30 seconds divided by the best 10-second reading. 100% means the device never slowed down.

1. On the **Throttle Test** card, choose **CPU** or **GPU**, and **5 min** or **15 min**.
2. Add a label, such as *With case* or *On a stand*, so you can tell runs apart later.
3. Tap **Start 5-minute test** (or **Start 15-minute test**) and keep Therbie on screen. The screen stays on during the test.
The test stops early in three cases:
- **You leave Therbie.** iOS doesn't allow the test in the background.
- **The device reaches Critical.** Therbie stops the test itself.
- **The device is already at Critical.** The test doesn't start.
**Which length?** Use 5 minutes for the CPU and 15 for the GPU. In the developer's tests on an iPhone 17 Pro, iPad Air and iPad mini, CPU speed settled within about 4 minutes. The GPU kept dipping and recovering for 10 to 15 minutes. [How long should a throttle test be?](https://irrhuh.app/therbie/kb/throttle-test-length.html) has the numbers.
> **Important** A throttle test warms the device and uses battery.
## Compare runs fairly
Results depend on the room as much as the device.
- **Start each run at Normal.** If the device was Warm or under test in the last 10 minutes, a **Leftover heat** notice says how long to wait. iOS can report Normal before the inside has fully cooled.
- **Keep the setup the same:** charge state, screen brightness and position.
- **Label every run,** then compare two in **Saved Runs › Compare Two Runs**. You can show both as GFLOPS or as **% of Peak**.
- **Low Power Mode lowers results.** Therbie warns you when it's on.
- **Debug builds** installed from Xcode show lower CPU results and a **Debug build** note. The % kept isn't affected.
## Charger Test
The **Charger Test** card times how fast the battery fills on a charger, cable or pad, in percentage points per hour.
1. Type what you're testing, or tap a suggestion such as **Cable**, **MagSafe** or **Wireless pad**.
2. Plug in, then tap **Start**. Until you plug in, the button reads **Plug in to start**.
3. Keep Therbie on screen. The test needs at least two changes of battery level, which takes 10 to 30 minutes.
The card shows **Time on charger**, **Battery**, **Charging speed** and **Level changes**. Finished tests appear under **Saved tests**.
- **Best range:** start between 20% and 75%. Above 80%, iOS slows charging on purpose, and Therbie warns that the test will read slow.
- **Speed bands, from the card's ⓘ:** Fast is 90 %/h or more; standard is 50 to 90; slow is 25 to 50; very slow is under 25.
- **Privacy:** tests stay on the device.
## On the Mac
Therbie for Mac collects benchmark and throttle results from your paired devices and compares them on one chart. It can also start tests on them. See [Therbie for Mac](https://irrhuh.app/therbie/guide/mac-app.html#runs-compare) and [Testing devices from your Mac](https://irrhuh.app/therbie/guide/device-link.html).
---
id: history-insights
type: screen
title: History and Insights
summary: Therbie's History keeps CPU, memory, thermal state, battery and network readings for 14 days, at 5-second, 1-minute and 15-minute resolution. It records only while Therbie is running, so gaps are normal. Insights turn History into plain findings for today and this week.
section: device
url: "https://irrhuh.app/therbie/guide/history-insights.html"
related: [dashboard, widgets, floating-monitor, background-limits, mac-app]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
opens_from: [dashboard]
---
# History and Insights
Therbie keeps a record of your device's CPU, memory, thermal state, battery and network on the device itself, and draws it as charts. The **Insights** card turns that record into short findings, such as "Ran warm 3 times today". To open the charts, go to the **Device** tab and tap **Show History** on the **History** card.

## How much is kept
| Range | One reading per | Covers |
|---|---|---|
| **1H** | 5 seconds | The last hour |
| **24H** | 1 minute | The last 24 hours |
| **14D** | 15 minutes | The last 14 days |
Older readings are deleted from the device after 14 days. A paired Mac keeps its copy longer; see [Therbie for Mac](https://irrhuh.app/therbie/guide/mac-app.html).
Each longer range keeps the average CPU, the peak CPU, the average memory, the hottest thermal state, the last battery level and the average network speed.
## When Therbie records
Therbie can only record while it's running:
- while Therbie is on screen;
- while the [floating monitor](https://irrhuh.app/therbie/guide/floating-monitor.html) is open;
- each time a widget or the Control Center control refreshes;
- each time a Shortcuts action runs;
- every 10 seconds while a sensor keeps Therbie running in the background, for example during a trip.
Time with no readings is shaded on the charts. Gaps are normal and are never filled in.
> **Tip** Keep a Therbie widget on a Home Screen page you visit often. Each widget refresh adds a reading, which fills in more of the day.
Benchmarks, throttle tests and floating-monitor sessions appear on the charts as marked periods, so you can see why the device was hot at a given time.
If a sensor is on, its own chart appears in History too, for example Vibration, Sound Level or Barometer. See the sensor pages, such as [Motion instruments](https://irrhuh.app/therbie/guide/sensors-vibration.html).
## Insights
The **Insights** card shows the most notable finding from **Today**. Tap **Show All** to see every finding for **Today** (midnight to now) and **This Week** (the last 7 days, including today). Findings can cover:
- how much of the period Therbie saw, so a quiet chart isn't mistaken for a quiet device;
- time spent Warm or hotter, or that the device stayed cool;
- the busiest hours of the day;
- average CPU and memory use;
- charging that was slower than usual, or normal;
- how much cellular data you've used this billing cycle;
- findings from sensors that are on, such as steps, a falling barometer, or the loudest moment.
Insights only state what the readings show. When there isn't enough data, the card says so.
## On the Mac
Therbie for Mac keeps the same History for the Mac itself. It also shows the History it receives from your paired iPhones and iPads. See [Therbie for Mac](https://irrhuh.app/therbie/guide/mac-app.html).

---
id: alerts
type: screen
title: Alerts
summary: Therbie can send a notification when the device turns Hot, when memory use passes a level, when the battery charges to a level, or when it runs low. Alerts only work while Therbie is running, for example on screen or with the floating monitor open.
section: device
url: "https://irrhuh.app/therbie/guide/alerts.html"
related: [background-limits, floating-monitor, thermal-states, battery, troubleshooting]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
opens_from: [dashboard]
---
# Alerts
Therbie on iPhone and iPad can send you a notification in four cases: the device turns Hot, memory use passes a level you choose, the battery charges to a level, or the battery runs low. **Alerts only work while Therbie is running**:
- while Therbie is on screen;
- while the [floating monitor](https://irrhuh.app/therbie/guide/floating-monitor.html) is open;
- while a sensor keeps Therbie running in the background, for example during a trip.
When iOS has paused Therbie, nothing is checked.
## Turn alerts on
1. Tap **⋯ › Alerts**.
2. Switch on the alerts you want. iOS asks for notification permission the first time you turn one on. Therbie doesn't ask at launch.
3. Tap **Send Test Alert** to see what an alert looks like.
All four alerts are off until you turn them on.
| Alert | Fires when | Setting |
|---|---|---|
| **Hot** | The thermal state reaches Hot or Critical | None |
| **High memory** | Memory in use (App, Wired and Compressed) reaches the level | 70% to 95% in steps of 5. Default 90% |
| **Charged to** | The battery reaches the level while charging | 50% to 100% in steps of 5. Default 80% |
| **Battery low** | The battery drops to the level while on battery power | 5% to 50% in steps of 5. Default 20% |
If notifications are turned off for Therbie in iOS Settings, the Alerts sheet says so and shows **Turn On in Settings**.
## When an alert fires
- **Only on a change.** An alert fires when a reading *reaches* its level while Therbie is watching, not because it was already past the level when Therbie started. For example, if the battery is already at 85% when you open Therbie, **Charged to** 80% won't fire until the level drops below 80% and rises again.
- **Not over and over.** The same alert doesn't repeat within 10 minutes, even if you close and reopen Therbie.
- **Re-arming:**
- **Hot** can fire again only after the device has been Warm or cooler for 2 minutes.
- **High memory** re-arms once use drops 5 points below the level.
- On devices that report single percents, a battery alert re-arms once the level moves 2 points back past it. On devices that report 5% steps, it re-arms one step back.
- **Not after a gap.** If Therbie hasn't taken a reading for more than 2 minutes, for example because it was closed, the alerts start over. Opening the app never brings up an old alert.
- **"About" on 5%-step devices.** Where iOS gives the battery level in 5% steps, the alert says "Battery at about 80%".
- **One of each kind.** A new alert of the same kind replaces the old one in Notification Centre.
## Why alerts need Therbie running
iOS pauses apps a few seconds after you leave them, and a paused app can't read the battery or the thermal state. So a charge alert only works while Therbie is running. [Why background alarms are rare](https://irrhuh.app/therbie/kb/background-limits.html) explains more.
> **Tip** Charging to 80%? Start the floating monitor, tuck it at the edge of the screen, and carry on. Therbie tells you when the battery gets there. For a charge alert that works with Therbie closed, use a Shortcuts automation instead: **Automation › New › Battery Level › Rises Above 80%**. The **Shortcuts & Siri** sheet in Therbie shows how.
---
id: widgets
type: reference
title: Widgets, Lock Screen and StandBy
summary: Therbie has seven widgets for the Home Screen, Lock Screen and StandBy, including one for your Mac's status, plus a Control Center control. iOS decides when widgets refresh, so each widget shows the time of its reading and turns to "Updated … ago" after 30 minutes.
section: device
url: "https://irrhuh.app/therbie/guide/widgets.html"
related: [dashboard, history-insights, mac-display, troubleshooting]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Widgets, Lock Screen and StandBy
Therbie on iPhone and iPad has seven widgets and one Control Center control. Each widget shows when its reading was taken, so you can tell a fresh number from an old one.
## The widgets
| Widget | Where and size | Shows |
|---|---|---|
| **Therbie Rings** | Home Screen: small, medium | CPU, memory, thermal state and battery as rings |
| **Single Metric** | Home Screen and StandBy: small | One reading in big numbers with a ring. Touch and hold, then **Edit Widget**, to choose CPU, memory, thermal, battery or storage |
| **Therbie Bars** | Home Screen: medium | CPU, memory, thermal state and battery as bars, with exact values |
| **Therbie Dashboard** | Home Screen: large | All four rings, plus the last hour of CPU load and thermal state |
| **Therbie Gauge** | Lock Screen: circular | One reading as a gauge. Touch and hold to choose which |
| **Therbie Summary** | Lock Screen: rectangular and inline | CPU, memory and thermal state, with the time of the reading |
| **Your Mac** | Home Screen: small, medium. Lock Screen: rectangular | Your Mac's CPU, memory, GPU and thermal state, as last received. See [Mac Display](https://irrhuh.app/therbie/guide/mac-display.html) |
To add one, touch and hold the Home Screen or Lock Screen, tap **Edit** (Home Screen) or **Customise** (Lock Screen), then **Add Widget**, and search for Therbie.
## How often widgets update
**iOS decides when widgets refresh.** Therbie asks for a refresh every 15 minutes, but iOS spaces refreshes out to save battery, especially when the battery is low. Apple's WidgetKit documentation describes a widget that people look at often as getting about 40 to 70 refreshes a day, roughly every 15 to 60 minutes.
- **Each refresh takes a fresh reading** and saves it to [History](https://irrhuh.app/therbie/guide/history-insights.html). That's how Therbie fills in a day's chart even when you don't open the app.
- **Every widget shows when its reading was taken,** for example **Updated 3:41 PM**. If iOS hasn't refreshed it for 30 minutes, the label changes to **Updated 40 min ago** in orange, so an old reading is obvious.
- **Leaving Therbie refreshes all widgets,** as long as iOS allows it.
## StandBy
StandBy shows two small widgets side by side while an iPhone charges on its side, in landscape. **Single Metric** is made for it: in StandBy the background disappears and the ring and number fill the space. At night, StandBy turns everything red. The widgets never use colour as the only signal, so they still read clearly.
## The Control Center control
The Therbie control shows CPU and memory as a gauge icon, and opens Therbie when you tap it. At the smallest size, Control Center shows only the icon. The gauge follows CPU load, and a thermometer takes over when the device is Hot. Resize the control to the wider size to see the numbers, for example *CPU 23% · Mem 61%*.
To add it, open Control Center, tap **+**, then **Add a Control**, and choose Therbie.

## Live Activities
Two Therbie features also show on the Lock Screen and in the Dynamic Island while they run. These are Live Activities, not widgets:
- the [floating monitor](https://irrhuh.app/therbie/guide/floating-monitor.html);
- a recording trip, with **Lap** and **Mark** buttons. See [Location and trips](https://irrhuh.app/therbie/guide/sensors-location.html).
Turn them off in **Settings › Therbie › Live Activities**.
---
id: sensors-vibration
type: screen
title: Motion instruments
summary: Therbie's Vibration sensor turns an iPhone or iPad's motion sensors into a seismograph, vibration meter, frequency spectrum, spirit level, compass, magnetic field meter and rotation meter. It logs average and peak vibration to History every second and can record named sessions. No permission is needed.
section: device
url: "https://irrhuh.app/therbie/guide/sensors-vibration.html"
related: [sensors-sound, sensors-location, history-insights, privacy-security]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Motion instruments
The Vibration sensor in Therbie turns your iPhone or iPad's motion sensors into a set of instruments: a seismograph, a vibration meter, a frequency spectrum, a spirit level, a compass, a magnetic field meter and a rotation meter. It also logs how much the device shook, so you can look back at it in History.
It needs no permission. It's off until you turn it on.
## Turn it on
1. Go to the **Measure** tab and tap the **Vibration** tile.
2. The first time, a sheet explains the sensor and shows its settings. Tap **Turn On**.
After that, a tap on the tile turns Vibration on, and the tile's power button turns it off. When it's on, tap the tile to open the instruments full screen.
**Measure › Start › Vibration** turns the sensor on and starts recording a session straight away.
**When it runs:**
- **While Therbie is on screen.**
- **During a recording drive or ride, even with the screen locked.** This is controlled by **Record vibration with drives** and **Record vibration with rides** under Location in **⋯ › Sensors**. Both are on by default. See [Location and trips](https://irrhuh.app/therbie/guide/sensors-location.html).
## The instruments
| Panel | What it shows |
|---|---|
| **Seismograph** | Acceleration along the device's X, Y and Z axes, newest on the right. Choose 2, 5 or 10 seconds at the bottom. The scale (±m/s²) adjusts to the largest movement on screen |
| **Intensity** | How strongly the device is shaking right now: the RMS (root mean square) of the acceleration over the last half second, on a scale from 0.01 to 10 m/s². A white line holds the highest level of the last 5 seconds |
| **Spectrum** | Which frequencies the shaking is made of, from 0 Hz up to half the reading rate. A motor, a washing machine or an engine shows as a clear peak |
| **Level** | A bubble level. Lay the device flat: the bubble turns green within 1° of level |
| **Compass** | Heading from magnetic north. Keep the device away from magnets and metal for a steady reading |
| **Magnetic field** | Field strength in µT (microtesla) on a 0–200 µT bar, with Earth's usual 25–65 µT shaded, and an arrow for its direction. It jumps near a magnet, a speaker, or iron and steel, so it works as a magnet and steel finder. It can't find aluminium, copper, gold or silver. Shows **Calibrating…** until iOS has calibrated the magnetometer: move the device in a figure of eight |
| **Rotation** | How fast the device is turning, in degrees per second and rpm, with a bar for each axis. The dial goes up to 720°/s |
**Intensity bands**, loosely based on the ISO 2631 comfort scale:
| Band | RMS acceleration |
|---|---|
| Still | Under 0.03 m/s² (the sensors' own noise) |
| Faint | 0.03 to 0.05 m/s² (a desk someone is typing on) |
| Light | 0.05 to 0.315 m/s² |
| Moderate | 0.315 to 1 m/s² |
| Strong | 1 to 2.5 m/s² |
| Severe | Above 2.5 m/s² |
## Purpose
**Purpose** chooses what the first instrument measures. Change it with the menu at the top left of the instruments, or under Vibration in **⋯ › Sensors**.
| Purpose | What it shows | Use it for |
|---|---|---|
| **General** | Overall shaking (RMS of all three axes) | Anything |
| **Ride comfort** | Vibration weighted the way ISO 2631-1 weights it for a seated person, with the standard's comfort scale: from "Not uncomfortable" under 0.315 m/s² to "Extremely uncomfortable" at 2.5 m/s² and above | Comparing cars, seats or roads. Mount the device firmly to the seat rail or floor, the same way in each car |
| **Suspension** | Up-and-down motion split into body movement (0.5–3 Hz) and wheel hop (8–20 Hz), with the body's bounce frequency | Tuning dampers and springs. Fix the device firmly to the body or corner being tuned |
| **Impacts** | Separate hits over a threshold, their count and the peak | Bumps, potholes, drops, bats and rackets. Set the threshold in **A hit is over**: 0.5, 1, 2, 4 or 8 g (default 2 g) |
## Sessions
1. Tap **Record Session** at the bottom of the instruments.
2. Name it, for example "Car A, highway", and tap **Record**. Without a name, the session is called by its purpose and the date.
3. When you're done, tap the same button, which now reads **Stop "Car A, highway"** with the seconds recorded.
Each session keeps one row a second. **Sessions** (top left) lists them side by side with their averages. From there you can use **Share Comparison (CSV)**, **Share Session (CSV)** and **Delete Session**. Sessions also appear on the **Sessions** tab.
For a fair comparison, use the same mount, road and speed each time.
## Settings
Under Vibration in **⋯ › Sensors**:
- **Purpose:** described above.
- **A hit is over:** the Impacts threshold.
- **Readings:** how many times a second the motion sensors are read, **50** or **100** (default 100). A sensor can only show vibrations up to half as fast as it's read, so 100 a second shows shaking up to 50 Hz (medium battery use) and 50 a second up to 25 Hz (less battery). Engine boom and road roar above 50 Hz are better measured with the [Sound Level](https://irrhuh.app/therbie/guide/sensors-sound.html) sensor.
## What's logged and where it goes
- **History:** while Vibration is on, Therbie logs the average and peak intensity every second. History shows a Vibration chart (average, shaded up to the peak) for 1H, 24H and 14D. Insights can mention the strongest shaking of the day and how much of the logged time the device was moving.
- **Sessions:** kept on the device until you delete them.
- **Paired Mac:** the vibration log goes to a paired Mac with the rest of History, and sessions are sent too, as summaries and CSV files. See [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html).
Nothing else leaves the device, except CSV files you share yourself.
## Good to know
- The phone's own vibration motor, speaker and handling show up too. To measure something else, rest the device on it without holding it.
- Phone motion sensors are made for movement, not lab measurement. Treat the numbers as a comparison between moments and places, not as calibrated values.
---
id: sensors-sound
type: screen
title: Sound level
summary: Therbie's Sound Level sensor is a decibel meter that uses the microphone. It shows the level with a peak hold, the last minute, a spectrum and a spectrogram. It never records audio; it keeps only levels, and, if you turn on Identify sounds, the names of sound types.
section: device
url: "https://irrhuh.app/therbie/guide/sensors-sound.html"
related: [sensors-vibration, history-insights, shortcuts-siri, privacy]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Sound level
The Sound Level sensor in Therbie turns your iPhone or iPad's microphone into a sound meter. It shows how loud it is now, how loud it has been, and which pitches the sound is made of.
**It never records audio.** Each moment of sound is turned into a level and a spectrum, then dropped. Nothing that could be played back is kept or sent anywhere.
## Turn it on
1. Go to the **Measure** tab and tap the **Sound Level** tile.
2. The first time, a sheet explains the sensor and shows its settings. Tap **Turn On**.
3. Allow the microphone when iOS asks.
After that, a tap on the tile turns Sound Level on, and the tile's power button turns it off. When it's on, tap the tile to open the meter full screen.
If you didn't allow the microphone, the Sensors screen says **Not allowed. Change it in Settings › Therbie.**
## The meter
| Panel | What it shows |
|---|---|
| **Level** | The current level on a 20–120 dB gauge in loudness colours, with a white mark for the highest level of the last 3 seconds |
| **Last minute** | The level over the last minute, with the average (an energy average, as sound meters calculate it) and the maximum since the sensor started measuring |
| **Spectrum** | How loud each pitch is, from 50 Hz (deep hum) to 16 kHz (hiss), with the strongest one named |
| **Spectrogram** | The last 10 seconds of the spectrum as a picture: time across, pitch up, brighter for louder. Speech, music and machines each leave their own pattern |
**Loudness bands**, following common hearing guidance:
| Band | Level |
|---|---|
| Quiet | Under 40 dB |
| Moderate | 40 to 70 dB |
| Loud | 70 to 85 dB |
| Harmful if long | 85 to 100 dB |
| Dangerous | Above 100 dB |
Around 85 dB is usually considered safe for about 8 hours a day, and every 3 dB louder halves that time. Therbie is not a hearing-protection device.
## Accuracy
Phone microphones aren't calibrated sound meters, and iOS doesn't tell apps how sensitive yours is. Therbie's levels are estimates, good for comparing places and moments.
If you have a sound meter, adjust **Calibration** under Sound Level in **⋯ › Sensors** until the two agree. It's set in dB at full scale, from 80 to 120 (default 100).
## Identify sounds
**Identify sounds** is off by default. When it's on, Apple's on-device sound classifier names what it hears, for example traffic, rain, birds or voices. The names appear as chips in the meter.
- **Only the names are kept,** in the sound log's `sources` column. No audio is kept.
- **Battery use becomes high.**
- **Where:** turn it on under Sound Level in **⋯ › Sensors**.
## What's logged
While Sound Level is on, Therbie logs the average and peak level every second to History. History shows a Sound Level chart. Insights can mention the loudest moment of the day, and how much of a day's safe noise exposure you had.
## Sound log (frequency bands)
**Log frequency bands** is on by default. While Sound Level runs, Therbie keeps a log of levels as a CSV file per day:
- **What each row holds:** the level and 26 third-octave bands from 50 Hz to 16 kHz.
- **How often:** **One row every** 1 second, 10 seconds (default) or 1 minute.
- **How long:** 30 days on the device.
- **What it isn't:** it's levels only, so speech can't be recovered from it.
Each file starts with lines beginning with `#` that describe the columns: time in UTC, energy average, loudest and quietest level, one column per band in dB, and `sources`. They also say how the levels are calibrated. Spreadsheets and scripts can read the file as it is, for example with pandas: `read_csv(..., comment="#")`.
To share it, open the meter and tap **Sound Log**, then choose **Share the Last 7 Days** or a single day. The sound log also appears on the **Sessions** tab. In Shortcuts, the **Get Sound Log** action returns a day's file.
## In the background
Sound Level runs while Therbie is on screen. It also keeps running when you switch apps or lock the device in two cases:
- **Keep logging in the background** is on (under Sound Level in **⋯ › Sensors**). It's off by default.
- **A trip is recording** while Sound Level is on.
While it runs in the background, the microphone stays on, iOS shows its orange indicator, and battery use is high. Therbie also keeps History's CPU, memory, heat and battery readings going every 10 seconds. To stop it, turn the setting or the sensor off, or stop the trip.
## Where the data goes
Levels, the sound log and identified sound names stay on the device. They are also sent to a Mac you've paired, with History; see [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html). Nothing else leaves the device, except files you share yourself.
---
id: sensors-location
type: screen
title: Location and trips
summary: Therbie's Location sensor shows a live map with your track, speed, altitude, heading and GPS quality, and records trips (walks, runs, hikes, rides, drives) with splits, climbing, replay and GPX export. A recording trip keeps going with the screen locked. Trips sync to a paired Mac.
section: device
url: "https://irrhuh.app/therbie/guide/sensors-location.html"
related: [sensors-sky, sensors-lap-timer, sensors-satellites, shortcuts-siri, pairing, privacy]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Location and trips
The Location sensor in Therbie shows where you are and how you're moving. It also records trips: walks, runs, hikes, rides and drives.
## Turn it on
1. Go to the **Measure** tab and tap the **Location** tile.
2. The first time, a sheet explains the sensor and shows its settings. Tap **Turn On**.
3. When iOS asks, choose **Allow While Using App**. Keep **Precise** on: with Approximate Location, positions can be off by a kilometre or more.
After that, a tap on the tile turns Location on, and the tile's power button turns it off. When it's on, tap the tile to open the map full screen.
## The map
- **Your track** from the last 30 minutes, or the trip you're recording. **Colour by** at the top right switches between **Speed** (blue slow, red fast) and **Altitude** (green low, brown high).
- **Speed** (or pace for walks, runs and hikes), **altitude** and **heading**. Heading is your direction of travel, so it needs you to be moving.
- **A shaded circle** around you when the position is uncertain by more than 15 m.
## GPS quality
The GPS quality panel shows how good the position is, as iOS reports it:
- **Accuracy in metres:** Excellent under 6 m, Good under 15 m, Fair under 40 m, Poor above.
- **A chart of the last 120 fixes,** about two minutes at one fix a second.
- **How often fixes arrive.**
- **Whether Precise Location is on.**
- **Where the fix came from:** whether it came from an accessory or was simulated.
iOS doesn't let apps see which satellites the device is using, or how strong they are, so there's no satellite list. For where satellites should be in your sky, see [GNSS sky plot (predicted)](https://irrhuh.app/therbie/guide/sensors-satellites.html).
## Record a trip
1. Tap **Start a Trip** and choose **Walk**, **Run**, **Hike**, **Ride**, **Drive** or **Trip**. You can also go to **Measure › Start** and tap **Drive**, **Ride** or **Walk**.
2. While it records, the panel shows distance, time, average speed (or average pace), top speed and climbing. **Lap** and **Mark** buttons are below.
3. Tap **Stop Drive** (or **Stop Walk**, and so on) to save it.
**While a trip records:**
- **It keeps recording with the screen locked or another app open,** until you stop it. Trips record at the best GPS accuracy, so they use more battery. Short pauses don't count as moving time.
- **The Lock Screen and Dynamic Island show it as a Live Activity,** with **Lap** and **Mark** buttons.
- **Other sensors can record with it.** **Record height with trips** (on by default) turns the Barometer on for the trip. **Record vibration with drives** and **…with rides** (both on by default) do the same for Vibration. If Sound Level is on, it keeps measuring too. Change these under Location in **⋯ › Sensors**.
- **Therbie keeps History's CPU, memory, heat and battery readings going,** every 10 seconds, while it runs in the background.
- **If Therbie is closed during a trip and reopened within 10 minutes,** the trip resumes, with a "Resumed" mark. A trip left unfinished for longer is closed at its last activity.
Shortcuts can start, stop and mark a trip, for example from a CarPlay automation. See [Shortcuts and Siri](https://irrhuh.app/therbie/guide/shortcuts-siri.html).
## Your trips
**Trips** (top left of the map) lists every trip; they also appear on the **Sessions** tab. Open one to:
- see it on the map, and **Replay** it;
- look at the elevation profile, and splits per km (or mile);
- read its marks, hard moments (hard braking, acceleration, sharp turns and jolts) and laps;
- **Export GPX** for other mapping and fitness apps.
Swipe left on a trip to delete it.
## Speed head-up display
The Location screen's **Head-Up Display** button (a gauge, at the top left) opens a big speed readout. See [Sun & Moon](https://irrhuh.app/therbie/guide/sensors-sky.html#speed-head-up-display).
## Logging in the background without a trip
**Keep logging in the background**, under Location in **⋯ › Sensors**, is off by default. When it's on, Therbie logs your speed and distance to History while it's off screen, even when no trip is recording. iOS shows the location indicator, and battery use is high.
## What's logged and where it goes
- **History:** while Location is on, Therbie logs your speed and the distance you covered.
- **Trips:** kept on the device until you delete them.
- **Paired Mac:** trips, with their full routes, are sent to a Mac you've paired. A trip you delete on the Mac is also deleted on the device. See [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html).
- **GPX files** go wherever you send them.
Nothing else leaves the device. The map itself comes from Apple Maps, which downloads map images for the area you're looking at.
---
id: sensors-lap-timer
type: guide
title: Lap timer
summary: Therbie's Lap Timer times laps of a circuit from GPS, for track days and karting. It has a start/finish line and sectors on the map, live gain or loss against your best lap, a speed or braking trace, a g-g diagram, and CSV and GPX export. It runs only while Therbie is on screen, accurate to roughly 0.1 to 0.3 seconds.
section: device
url: "https://irrhuh.app/therbie/guide/sensors-lap-timer.html"
related: [sensors-location, sensors-vibration, privacy]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Lap timer
The Lap Timer in Therbie times laps of a circuit using the phone's GPS. It shows:
- the lap you're on, your last lap and your best lap;
- whether you're gaining or losing time against your best lap as you drive;
- your line on the map;
- a g-g diagram of your braking, accelerating and cornering.
It's for comparing your own laps on track days and karting, not for official timing.
## Before you start
1. Go to the **Measure** tab and tap the **Lap Timer** tile, or tap **Measure › Start › Laps**.
2. The first time, a sheet explains the sensor. Tap **Turn On**. The Lap Timer uses the Location sensor's GPS, so this turns Location on too.
3. If iOS asks, choose **Allow While Using App** and keep **Precise** on.
4. Mount the phone firmly in the vehicle. The g-g diagram needs a phone that can't move around.
**Keep Therbie on screen while you drive.** The Lap Timer has no background mode. Leaving the screen pauses timing and saves the session.
## Set the start/finish line
You can set the line in two ways:
- **Tap 2 Points:** tap one edge of the track on the map, then the other edge.
- **Here:** drive to the line and tap **Here**. Therbie puts a 30 m line across your direction of travel, where you are. This needs you to be moving; otherwise Therbie asks you to drive a little first.
The line is kept until you change it, so you set it once per track.
**Sectors** are optional. After the start/finish line is set, tap **Add Sector** and choose **Tap 2 Points** or **Here, Across My Direction**. Add sector lines in the order you drive them. Sector times appear under each lap. **Clear Sectors** removes them. You can't change sectors during a session.
## Time a session
1. Tap **Start Session**. The first time you cross the line, the out lap ends and lap 1 starts. Each crossing after that completes a lap.
2. Watch the timing:
- **Lap time:** the time on the lap you're driving now.
- **VS BEST:** green means you're ahead of your best lap at this point of the lap; red means you're behind. Therbie compares the two laps at the same distance from the line, not at the same time.
- **Last** and **best** laps. The best lap and best sectors are purple.
3. Tap **Stop and Save Session** when you finish.
The session is also saved after every lap and every minute, so you lose very little if Therbie is closed.
## Trace and g-g diagram
- **The trace** is drawn on the map. Colour it by **Speed** (blue slow, red fast) or by **Brake/Accel** (red braking, white coasting, green accelerating). Tap a lap in the list to see that lap.
- **The g-g diagram** (friction circle) shows how hard you're braking (down), accelerating (up) and cornering (left and right), in g.
- The orange dots are one per GPS fix this session.
- The live white dot and its trail come from the motion sensors, 50 times a second.
- Therbie works out which way the phone faces from GPS speed and direction, so drive with some braking and turns before the live dot appears. If you move the phone, it learns the new position again within a minute or so.
## Sessions and export
Tap **Sessions** (top left) to see saved lap sessions; they also appear on the **Sessions** tab. Open a session to see its laps, sector splits and traces. Swipe left on a session to delete it.
You can export a session as:
- **CSV, one row per GPS fix:** columns `time`, `lat`, `lon`, `speed_mps` (metres per second), `ax_g` and `ay_g` (longitudinal and lateral acceleration in g) and `lap`. Lap 0 is the out lap.
- **GPX:** one track segment per lap, for mapping apps and lap-analysis tools.
## How accurate is it?
Phone GPS gives about one fix a second. A crossing of the line falls between two fixes, so Therbie works out the crossing time from where the line cuts the path between them. This makes laps accurate to roughly **0.1 to 0.3 seconds**: good enough to compare your own laps, not for official timing.
- **Fixes worse than 30 m are ignored.**
- **Accuracy is best** with a clear view of the sky, Precise Location on, and the line on a fast straight rather than in a slow corner.
- **Positions are only as good as the GPS.** On a narrow track, two laps can show a few metres apart even if you drove the same line.
## Battery
Battery use is medium while the Lap Timer is on, and high while a session is timing, because GPS runs at its best accuracy.
## Where the data goes
Lap sessions, positions and laps stay on this device. They are not sent to a paired Mac. They leave the device only in a CSV or GPX file you export yourself.
---
id: sensors-barometer
type: screen
title: Barometer
summary: Therbie's Barometer sensor shows air pressure on a gauge, the 3-hour weather trend with a storm sign, relative altitude, and floors climbed and descended. It needs Motion & Fitness permission and a device with a barometer. Readings stay on the device and a paired Mac.
section: device
url: "https://irrhuh.app/therbie/guide/sensors-barometer.html"
related: [sensors-activity, sensors-location, history-insights, alerts]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Barometer
The Barometer sensor in Therbie reads the air pressure around your iPhone or iPad. Pressure tells you two things: where the weather is heading, and how far up or down you've gone. Therbie shows both.
Not every iPad has a barometer. On a device without one, the tile says **Not on this device**.
## Turn it on
1. Go to the **Measure** tab and tap the **Barometer** tile.
2. The first time, a sheet explains the sensor and shows its settings. Tap **Turn On**.
3. Allow **Motion & Fitness** when iOS asks.
After that, a tap on the tile turns the Barometer on, and the tile's power button turns it off. When it's on, tap the tile to open it full screen.
If you said no to Motion & Fitness, turn it on in **Settings › Privacy & Security › Motion & Fitness › Therbie**.
## The panels
| Panel | What it shows |
|---|---|
| **Pressure** | The pressure on a gauge in hPa (inHg where miles are used), with weather-barometer colours from stormy to dry. A dashed yellow hand shows where the pressure was 3 hours ago, like the set hand on a wall barometer |
| **Weather trend** | Whether the pressure is rising, steady or falling over the last 3 hours, by how much, and what that usually means, with a graph of those 3 hours |
| **Relative altitude** | How far you've gone up or down since you opened the screen, with the last 10 minutes drawn and a faint line for each floor |
| **Floors today** | Floors climbed and descended today, and your height above sea level with its accuracy, on devices that report it |
## The weather trend
Weather services describe pressure by how much it changed in the last 3 hours. Therbie uses the same measure:
| Trend | Change in 3 hours | Usually means |
|---|---|---|
| Rising fast | 3.6 hPa or more | Clearing quickly, often windy for a while |
| Rising | 0.5 to 3.6 hPa | Weather settling or improving |
| Steady | Less than 0.5 hPa either way | No change expected soon |
| Falling | 0.5 to 1.6 hPa | Unsettled weather may be on the way |
| Falling fast | 1.6 hPa or more | **Storm sign:** wind and rain likely within hours |
- **How much data it needs:** at least an hour of readings, and it gets better up to 3 hours. It's worked out from your History, so it carries on when you close and reopen Therbie, as long as the Barometer was on.
- **The daily tide is taken out.** Air pressure naturally rises and falls twice a day. When Therbie knows roughly where you are, it removes this daily tide from the trend. To do that it keeps a rough position, rounded to 0.1° (about 11 km), on the device.
- **Height matters.** Going up 10 m lowers the pressure by about 1.2 hPa, so a trip up a hill or a tall building looks like falling weather. Therbie warns you when your height changed while the trend was measured. For a true weather trend, leave the device in one place.
## Storm warning
**Warn when pressure falls fast** is off by default. Turn it on under Barometer in **⋯ › Sensors**; iOS asks for notification permission.
When it's on, Therbie sends a notification titled "Pressure falling fast" if all of these are true:
- the pressure fell 1.6 hPa or more in 3 hours;
- there are at least 2 hours of data;
- your height stayed steady.
It sends at most one every 6 hours, and only while the Barometer is running.
## Floors
Therbie counts a floor each time you go about 3 m up or down, by stairs or lift.
- **Small wobbles don't count.** After a floor is counted, you have to go a whole floor further up, or a whole floor back down, before the next one counts. Slow changes from the weather aren't counted either.
- **Floor height:** if floors in your building are taller or lower, change it under Barometer in **⋯ › Sensors**, from 2.5 to 4.5 m in steps of 0.5 m (default 3 m).
- **Reset Today's Floors** starts today's count again.
## When it runs
- **While Therbie is on screen.**
- **During a recording trip,** when **Record height with trips** is on (the default). See [Location and trips](https://irrhuh.app/therbie/guide/sensors-location.html).
Battery use is low.
## What's logged and where it goes
- **History:** the pressure is logged about once a second, with floors climbed. Open **History** to see it over the last hour, day or two weeks.
- **Insights:** they mention a storm sign (a fall of 1.6 hPa or more in 3 hours) and how many floors you climbed today or this week.
- **Where it goes:** pressure, altitude and floors stay on the device. They also go to a Mac you've paired, with History.
## Good to know
- The pressure is what the sensor measures where you are, not the sea-level pressure on weather maps. Higher up it reads lower: at 300 m, about 35 hPa lower than the sea-level figure. The trend is what matters.
- Wind, air conditioning, and closing car doors or windows can make the pressure jump for a moment.
- A phone in a sealed waterproof case may react slowly.
---
id: sensors-activity
type: screen
title: Activity
summary: Therbie's Activity sensor shows today's steps against a goal, cadence, pace, distance and floors, a timeline of walking, running, cycling and driving since midnight, and steps for the last 7 days. It reads what iOS's motion coprocessor already counts and doesn't use HealthKit.
section: device
url: "https://irrhuh.app/therbie/guide/sensors-activity.html"
related: [sensors-barometer, sensors-location, history-insights]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Activity
The Activity sensor in Therbie shows how much you've moved today. Your iPhone's motion coprocessor counts steps, distance and floors all day, whether or not Therbie is open. Therbie only reads what's already counted, so Activity uses very little battery.
Activity needs a device that counts steps. iPads without step counting show the tile as **Not on this device**.
## Turn it on
1. Go to the **Measure** tab and tap the **Activity** tile.
2. The first time, a sheet explains the sensor and shows its settings. Tap **Turn On**.
3. Allow **Motion & Fitness** when iOS asks.
After that, a tap on the tile turns Activity on, and the tile's power button turns it off. When it's on, tap the tile to open it full screen.
If you said no to Motion & Fitness, turn it on in **Settings › Privacy & Security › Motion & Fitness › Therbie**.
## The Activity screen
| Panel | What it shows |
|---|---|
| **Steps today** | Steps since midnight as a ring that fills towards your daily goal. Past the goal, a second lap starts |
| **Cadence** | Steps per minute right now, on a gauge. Under 20 reads as not walking; then slow, walking from 100, brisk from 130, running from 150. It drops back within about 10 seconds of stopping |
| **Pace, distance and floors** | Your current pace (time per km or mile), today's distance, and floors climbed and descended. iOS estimates distance and pace from your stride. Floors need a barometer |
| **Today** | A bar from midnight to midnight, coloured by what you were doing: walking, running, cycling, driving or still. A white line marks now. Moments shorter than 2 minutes are folded into what came before or after, so a few steps at your desk don't break up the bar. The total time walking, running and cycling is shown above it |
| **Last 7 days** | Steps for each of the last 7 days, today brightest, with your goal as a dashed line |
**Daily step goal:** change it under Activity in **⋯ › Sensors**, from 2,000 to 30,000 in steps of 1,000. The default is 10,000.
## What's logged
While Activity is on, Therbie logs today's step count to History, with the steps added since the last reading. The coprocessor keeps counting while Therbie is closed, so steps you took in the meantime are logged the next time Therbie runs, and each day's total adds up. History shows an Activity chart.
Insights can tell you how many steps you've taken today or this week, and how that compares with your daily average over the days before.
## Where the data goes
- **Read from iOS:** steps, floors and activities come from iOS's motion data. Therbie doesn't use HealthKit on iPhone or iPad.
- **Kept on the device:** in Therbie's History.
- **Paired Mac:** your logged step counts go to a Mac you've paired, as part of History. See [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html).
Nothing else leaves the device.
---
id: shortcuts-siri
type: reference
title: Shortcuts and Siri
summary: Therbie adds actions to Siri, Spotlight, the Shortcuts app and the Action Button. Five read the device (Device Status, Thermal State, CPU Usage, Memory Usage, Battery Level); others start and stop trips and share sensor logs. Every Siri phrase ends with "in Therbie".
section: device
url: "https://irrhuh.app/therbie/guide/shortcuts-siri.html"
related: [alerts, widgets, sensors-location, sensors-sound]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Shortcuts and Siri
Therbie on iPhone and iPad adds actions that work without opening the app. You can ask Siri, search Spotlight, put one on the Action Button, or use them in your own shortcuts and automations. Every Siri phrase includes "in Therbie" so Siri knows which app you mean.
## Reading the device
| Action (in Shortcuts) | Returns | Example Siri phrase |
|---|---|---|
| **Get Device Status** | CPU, memory, thermal state and battery together. Tap the result in a shortcut to pick one | "Check status in Therbie" |
| **Get Thermal State** | Normal, Warm, Hot or Critical | "How hot is my phone in Therbie" |
| **Get CPU Usage** | A whole number from 0 to 100 | "Get CPU usage in Therbie" |
| **Get Memory Usage** | Percent in use, GB used or GB total (you choose) | "How much memory is used in Therbie" |
| **Get Battery Level** | A whole number from 0 to 100. On devices that report 5% steps, Siri says "about" | "Check battery in Therbie" |
Each action takes a fresh reading, which takes about half a second, and saves it to [History](https://irrhuh.app/therbie/guide/history-insights.html). "In use" memory means App, Wired and Compressed memory; see [Memory, explained](https://irrhuh.app/therbie/kb/memory.html).
On a device that doesn't report a battery level to apps, **Get Battery Level** returns an error saying so.
## Trips and sensor logs
| Action | What it does |
|---|---|
| **Start Trip** | Starts recording a trip, for example a drive. See [Location and trips](https://irrhuh.app/therbie/guide/sensors-location.html) |
| **Stop Trip** | Stops and saves the trip that's recording |
| **Mark Trip** | Adds a mark to the trip at this moment |
| **Get Sound Log** | Returns a day's sound log file. See [Sound level](https://irrhuh.app/therbie/guide/sensors-sound.html) |
| **Get Plant Readings**, **Get Plant Note** | Readings and a daily note from a Bluetooth plant sensor (Bluetooth Sensors) |
| **Get Bluetooth Survey** | The Bluetooth survey's counts (Bluetooth Sensors) |
| **Get Datapoint Counts** | How many readings of each kind Therbie has recorded |
The first time, iOS asks whether to turn on Therbie's shortcuts with Siri.
## Without Siri
- **Spotlight:** swipe down on the Home Screen and type "Therbie" or "thermal". The actions appear as buttons.
- **Shortcuts app:** Therbie's ready-made shortcuts appear under Therbie in the **Shortcuts** tab. Tap one to run it, or add it to the Home Screen.
- **Action Button** (iPhones that have one): open **Settings › Action Button**, swipe to **Shortcut**, and choose **Device Status**. One press then shows how the phone is doing.
- **Type to Siri:** on devices with Apple Intelligence, double-tap the bottom edge of the screen to type instead of speak.
> **Tip** If holding the side button opens something other than Siri, search Settings for "side button".
## Example automations
The **⋯ › Shortcuts & Siri** sheet in Therbie lists three automations. Make them in the Shortcuts app's **Automation** tab, and choose **Run Immediately** so they don't ask each time.
1. **Warn me when a game starts hot:** **Automation › New › App** › choose the game › **Is Opened** › **Run Immediately**. Then add **Get Thermal State**, then **If** Thermal State is Hot, then **Show Notification** "Phone is hot".
2. **Log the battery every evening:** **Automation › New › Time of Day** › 9:00 PM, Daily › **Run Immediately**. Then add **Get Battery Level** and **Append to Note**, with the Battery Level in the text.
3. **Charge alarm, even when Therbie is closed:** **Automation › New › Battery Level › Rises Above 80%** › **Run Immediately**. Then add **Show Notification**. This one is built into Shortcuts, so it works when Therbie isn't running.
---
id: sensors-light
type: screen
title: Light meter
summary: Therbie's Light Meter estimates how bright it is, in lux and EV, from the camera's own exposure. It also shows a photographic exposure table and colour temperature. No photo or video is taken or kept. It can log to History every minute, every 2 minutes or continuously while Therbie is on screen.
section: device
url: "https://irrhuh.app/therbie/guide/sensors-light.html"
related: [sensors-sound, history-insights, privacy]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Light meter
The Light Meter in Therbie estimates how bright a scene is, using the camera. iPhones and iPads have a light sensor for screen brightness, but iOS doesn't let apps read it.
**How it works:** the camera picks its own exposure (aperture, shutter time and ISO). From that, and how bright the picture comes out, Therbie works out how bright the scene is.
**No photo or video is taken or kept.** Each frame is read for its exposure and average brightness, then dropped at once.
## Turn it on
1. Go to the **Measure** tab and tap the **Light Meter** tile. **Measure › Start › Light** opens it too.
2. The first time, a sheet explains the sensor and shows its settings. Tap **Turn On**.
3. Allow the camera when iOS asks.
After that, a tap on the tile turns the Light Meter on, and the tile's power button turns it off. When it's on, tap the tile to open the meter full screen. The camera starts when you open the meter and stops when you close it, unless logging keeps it running (see below).
## The meter
| Panel | What it shows |
|---|---|
| **Brightness** | The estimated illuminance in lux, the exposure value (EV at ISO 100), everyday words for it, and the camera's own aperture, shutter time and ISO. There's a night-to-sun scale and a small live preview of what the camera sees |
| **Colour temperature** | How warm or cool the light is, in kelvin, estimated from the camera's white balance, on a 2,000 to 10,000 K scale |
| **Exposure for this light** | The shutter speed for a mid-grey exposure at f/1.8, f/2, f/2.8, f/4, f/5.6, f/8, f/11 and f/16, at ISO 100 and ISO 400, to the nearest third of a stop. "> 1/8000" or "> 30″" means the light is too bright or too dark for that setting |
- **Hold** (top left) freezes the reading, for example so you can note the exposure. **Release** goes live again.
- **Camera** (top left) switches between **Back camera** and **Front camera**. The same choice is in the settings.
## How it's worked out
- **EV at ISO 100** = log2(N² / t) − log2(ISO / 100), where N is the f-number and t the shutter time in seconds.
- **Correction:** the camera tries to make every scene mid-grey. When the picture comes out brighter or darker than that, Therbie corrects the EV by up to 3 stops.
- **Lux** ≈ 2.5 × 2^EV.
To save battery, the camera runs at a low resolution (640 × 480) and 15 frames a second.
## Accuracy
This is an estimate of **reflected** light: what the camera sees. A hand-held lux meter measures the light falling on a spot, which is different. Point the camera at a white wall and then a dark sofa under the same lamp, and you'll get different readings.
For the fairest reading, point it at a mid-toned or mixed scene, or hold a grey card in front of it. Readings are good for comparing rooms, times of day and lamps, and for the exposure table. They aren't calibrated.
## What's logged
**Log to History**, under Light Meter in **⋯ › Sensors**, has four choices:
| Choice | What happens |
|---|---|
| **Off** | Nothing is logged. The camera runs only while the meter is open |
| **Every minute** or **Every 2 minutes** | While Therbie is on screen, the camera comes on for about 3 seconds and logs one reading |
| **Continuously** | While Therbie is on screen, the camera stays on and Therbie logs the average, brightest and dimmest lux every second |
Nothing is logged while Therbie is off screen: the Light Meter has no background logging. Logged readings go to a Mac you've paired, with History.
## Battery
The camera uses a lot of power, so the Light Meter's battery use is **High** while the camera runs.
---
id: sensors-sky
type: screen
title: Sun & Moon
summary: Therbie's Sun & Moon tool shows sunrise, sunset, twilights, golden and blue hour, moonrise, moonset and the moon's phase, with a sky dome that turns with the compass. It works from your location or a place you choose. This page also covers the speed head-up display.
section: device
url: "https://irrhuh.app/therbie/guide/sensors-sky.html"
related: [sensors-location, sensors-satellites, privacy]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Sun & Moon
Sun & Moon in Therbie shows where the sun and moon are in your sky and when they rise and set. It's useful for photography (golden and blue hour), stargazing (when it's properly dark) and planning a day outdoors.
## Turn it on
1. Go to the **Measure** tab and tap the **Sun & Moon** tile.
2. The first time, a sheet explains the tool and shows its settings, including **Place**. Tap **Turn On**.
3. If **Place** is **Current location** and Location isn't already allowed, choose **Allow While Using App** when iOS asks.
After that, a tap on the tile turns Sun & Moon on, and the tile's power button turns it off. When it's on, tap the tile to open the sky dome full screen.
**Prefer not to share your position?** Set **Place** to a chosen place before you tap **Turn On**. Then no location permission is needed. Sun & Moon also works if you refuse location.
## The sky dome
The dome is a map of the sky seen from above. The middle is straight up, the rim is the horizon, and north, east, south and west are marked around it.
- **Paths:** the **yellow line** is the sun's path today and the **dotted line** the moon's, where they're above the horizon.
- **Now:** the **sun** and **moon** are drawn where they are now. When one is below the horizon, a dashed ring on the rim shows the direction it's in.
- **Colour:** the dome follows the light. It's blue by day, orange in golden hour, deep blue in the blue hour and twilight, and dark at night.
- **Turn with compass** is on by default. The dome turns so the direction you're facing is at the top, marked with a small triangle. Hold the device flat, screen up. Turn it off to keep north at the top.
## Times
Under the dome:
- **Sun** and **moon** direction (degrees from north) and height above the horizon, now.
- **Today's light** as a strip from midnight to midnight, with a line at now.
- **Astronomical, nautical and civil dawn and dusk**, **sunrise**, **sunset**, **solar noon** (with the sun's height) and **day length**.
- **Golden hour:** the sun between 6° above and 4° below the horizon. **Blue hour:** the sun 4° to 6° below.
- **The moon's phase**, how much of it is lit, and **moonrise** and **moonset**. Some days have no moonrise or no moonset, because the moon rises about 50 minutes later each day.
Far north or south, some events don't happen on some days, for example no night in midsummer or no sunrise in midwinter. They show as –.
Times are calculated with the NOAA solar calculator and Jean Meeus's *Astronomical Algorithms*. Hills, buildings and unusual weather shift what you actually see.
## Choosing a place
Set **Place** under Sun & Moon in **⋯ › Sensors**:
- **Current location:** uses the Location sensor's position when Location is on. Otherwise Therbie asks iOS for your position at most once every 15 minutes, while it's on screen.
- **Chosen place…:** **Find a city**, or **Or enter coordinates** (north and east positive) and tap **Use These Coordinates**. Times for a city are shown in that city's time zone. Times for typed coordinates are shown in this device's time zone. **Change Place…** changes it later.
## Battery and what's logged
- **Battery use is low.** Sun & Moon doesn't track you continuously; it recalculates once a minute. The compass runs only while the sky dome is open.
- **Nothing is logged.** Sun & Moon adds nothing to History.
## Privacy
Your position stays on this device. If you search for a city, the name you type is sent to Apple's geocoder to find it. Nothing else leaves the device.
## Speed head-up display
The speed head-up display is a big, simple speed readout for the dashboard of a car or the handlebars of a bike. It uses the Location sensor.
### Open it
1. Turn on **Location** (see [Location and trips](https://irrhuh.app/therbie/guide/sensors-location.html)).
2. Tap the **Location** tile on the **Measure** tab to open the map.
3. Tap **Head-Up Display** (the gauge button) at the top left.
### What it shows
- **Speed** in large digits: km/h, or mph where miles are used.
- **Heading:** the direction you're travelling. It needs you to be moving.
- **Distance:** the trip's distance while a trip is recording; otherwise the distance covered since you opened the display.
Tap the screen to show the controls. They fade after 4 seconds.
- **Mirror** flips the display left to right, so its reflection in a windscreen reads the right way round.
- **Night** turns everything red, which is easier on your eyes in the dark.
- **Close** goes back to the map.
The screen stays on while the display is open, and goes back to normal when you close it. The status bar is hidden.
> **Important** Don't look at the display instead of the road. Mount the device securely, keep it out of your line of sight, and follow local rules about devices in vehicles.
---
id: sensors-satellites
type: screen
title: GNSS sky plot (predicted)
summary: Therbie's GNSS Sky tool shows where GPS, Galileo, GLONASS and BeiDou satellites should be in your sky now and over the next 12 hours, calculated from published orbits. It can't show what your device actually receives. Orbit data downloads from CelesTrak only when you tap Download orbit data.
section: device
url: "https://irrhuh.app/therbie/guide/sensors-satellites.html"
related: [sensors-location, sensors-sky, privacy]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# GNSS sky plot (predicted)
GNSS Sky in Therbie shows where the navigation satellites (GPS, Galileo, GLONASS and BeiDou) **should** be in the sky above you. It shows how many are above the horizon and how that changes over the next 12 hours.
Use it to troubleshoot poor GPS: is the sky short of satellites right now, or is something (buildings, trees, a car roof) blocking them?
## Predicted, not received
iOS doesn't let apps see which satellites your iPhone or iPad's GPS receiver is tracking, or how strong their signals are. So Therbie **calculates** where the satellites are from their published orbits.
That means:
- **It shows what's overhead, not what your device receives.** A satellite on the plot can be blocked by a building and unused by your device.
- **It works the same indoors and outdoors,** and with GPS off.
- **For what your device's GPS is actually doing** (accuracy, update rate), see the GPS quality panel in [Location and trips](https://irrhuh.app/therbie/guide/sensors-location.html).
The screen's title is **GNSS Sky (Predicted)**, and every plot is labelled **Predicted from published orbits**.
## Turn it on
1. Go to the **Measure** tab and tap the **GNSS Sky** tile.
2. The first time, a sheet explains the tool. Tap **Turn On**.
3. Choose **Allow While Using App** if iOS asks. Therbie needs your rough position to know which part of the sky is yours. If Location is already on, it uses Location's position. Otherwise it asks once for a position accurate to about a kilometre, which is plenty. **Update Position** gets a fresh one.
4. Tap the tile to open the sky plot, then tap **Download orbit data**.
Your position is used on the device only, to work out your sky. It isn't stored or sent anywhere.
## Orbit data and your privacy
The orbits come from [CelesTrak](https://celestrak.org), a free public source of satellite orbit data. On iPhone and iPad, CelesTrak is the only internet server Therbie contacts that isn't Apple's. Apple's own services handle the map in Location and city search in Sun & Moon.
- **Nothing is downloaded until you tap Download orbit data.** Turning GNSS Sky on doesn't download anything by itself.
- **What's sent:** the request goes to celestrak.org over HTTPS, without cookies, and asks only for the four constellations' orbits. **No personal data is sent**: not your position, not any identifier. Like any website, CelesTrak sees your IP address.
- **How often:** at most once every 12 hours. Orbits don't change quickly.
- **Where it's kept:** on your device only, so the sky plot works offline afterwards. It isn't included in your device backup, because it can be downloaded again.
- **When it's stale:** data more than **14 days old** is marked **Stale**. Download again for accurate positions.
## The sky plot
- **Layout:** the **edge** of the circle is the horizon, and the **centre** is straight up (the zenith). Rings mark 30° and 60° above the horizon.
- **Turn with the compass** is on by default. The plot turns so the top points the way your device points: lay it flat, screen up, and the plot matches the sky around you. Turn it off to keep north at the top and east on the right, like a map.
- **Colours:** dots are coloured by constellation: **GPS** cyan, **Galileo** yellow, **GLONASS** red, **BeiDou** green.
- **Labels** are the satellite's number: G13 is GPS PRN 13, E11 is Galileo E11, C19 is BeiDou C19. GLONASS labels show the satellite's GLONASS number (for example R716), because the published names don't include its slot.
- **Tap a satellite** for its details (below). Its path over the next 12 hours is drawn as a dashed line.
- **Ring satellites that broadcast L5/E5a** is on by default. Satellites that send a second frequency get a white ring. See *Dual frequency* below.
- **Geostationary satellites:** BeiDou includes some, which sit still in the sky. From Europe and the Americas most of them are below the horizon.
## Satellite details
Tap a satellite on the sky plot or in the AR view to see:
- **What it is:** its number, name, constellation, generation (for example GPS IIF or Galileo FOC) and the year it was launched.
- **Where it is now (predicted):** direction, height above the horizon, distance, how long its signal takes to reach you, whether it's approaching or moving away, and its Doppler shift at GPS L1.
- **Its pass:** when it rises above your elevation mask, its highest point, and when it sets, within the next 12 hours.
- **Signals it broadcasts,** by generation, and its orbit (height, period, inclination, and the date of the orbit data).
Signal health and strength aren't in the published orbits, and iOS doesn't say whether your device is using a satellite, so neither is shown.
## Dual frequency (L5 and E5a)
Each generation of satellite broadcasts a different set of signals. GPS IIF and GPS III satellites broadcast **L5**, and every Galileo satellite broadcasts **E5a**, on a second frequency. Older GPS satellites (IIR, IIR-M) don't.
Dual-frequency receivers, such as those Apple lists as "dual-frequency GPS" in recent Pro iPhones' tech specs, use L5 and E5a alongside the usual L1/E1 signal to reject reflections off buildings. So the number of L5/E5a satellites up matters most in cities.
The sky plot rings those satellites and counts them. This shows what each satellite **sends**, not what your device **receives**. BeiDou-3's B2a signal is on the same frequency, but Apple lists only BeiDou B1 for iPhone, so BeiDou isn't ringed.
## AR sky view
Tap **AR Sky View** under the sky plot, allow the camera, and point your device at the sky, or at the ceiling: the positions are calculated, so walls and roofs don't matter.
- **Markers:** satellites appear as small markers in their constellation's colour, labelled with their number. Ringed ones broadcast L5/E5a; faded ones are below the elevation mask.
- **Guides:** white dots mark the horizon, orange dashes the elevation mask, and N, E, S and W are on the horizon.
- **Zoom:** pinch, or use the slider (digital zoom, up to 6×). **Tap** a satellite for its details.
- **Direction:** directions come from the compass, which is usually right to within 5 to 15° and worse near steel, magnets and electronics. If the markers look turned, move the device in a figure of eight and tap **Realign**.
- **Camera:** used only for the live view. Nothing is photographed, recorded or stored. Battery use is high while the AR view is open.
## Elevation mask
Satellites low on the horizon are usually blocked by buildings and terrain, and their signals cross more atmosphere, so receivers often ignore them. The **Elevation mask** sets the angle below which satellites are dimmed and not counted. It runs from 0° to 40° in steps of 5°; the default is 10°. Try 15 to 20° in a city.
## Counts and the next 12 hours
- **Counts** show how many of each constellation are predicted above the mask now.
- **Next 12 hours** shows the predicted number above the mask every 10 minutes, stacked by constellation. Look for dips if you're planning a survey or a recording in a difficult place.
## How accurate is it?
Therbie moves each satellite along its published orbit, including the slow turning of the orbit caused by Earth's equatorial bulge. It leaves out smaller effects (the pull of the Moon and Sun, and short-term wobbles), which full SGP4/SDP4 orbit software includes.
For these satellites, 20,000 to 36,000 km up, that leaves an error of tens of kilometres at most after two weeks. That's about a tenth of a degree as seen from the ground, far smaller than a dot on the plot. Older data drifts further, which is why it's marked stale after 14 days.
Earth's rotation uses the standard sidereal-time formula. The tiny differences between time scales, and the wobble of Earth's axis, add less than a hundredth of a degree.
## Battery and what's logged
- **Sky plot:** battery use is low. While the plot is open, Therbie works out positions every couple of seconds. It uses the compass while Therbie is on screen, and gets your position once.
- **AR view:** uses the camera and motion tracking, so its battery use is high while it's open.
- **Logging:** GNSS Sky doesn't log to History.
---
id: mac-display
type: task
title: Mac Display
summary: Mac Display shows your Mac's CPU, memory, GPU load, thermal state, network and battery full screen on a paired iPhone or iPad on the same network. Turn on sharing on the Mac first; it's off by default and read-only. A Your Mac card and widget show the last status received.
section: device
url: "https://irrhuh.app/therbie/guide/mac-display.html"
related: [pairing, mac-app, widgets, troubleshooting, privacy-security]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# Mac Display
Mac Display turns an iPhone or iPad into a status screen for your Mac. It shows big rings for CPU, memory and GPU load, plus the thermal state, network and battery, live over your local network. Prop a phone up beside a laptop and it works as a desk gadget.
**Before you start:**
- the iPhone or iPad must be [paired with the Mac](https://irrhuh.app/therbie/guide/pairing.html);
- both must be on the same network;
- the Mac must be sharing its status. Sharing is off by default.
## Turn it on
1. **On the Mac:** on the **This Mac** page, click the **iPhone & iPad Display** button in the toolbar. Switch on **Share this Mac's status with my iPhone and iPad**. The status line shows, for example, **Shared · 1 device watching**. The same switch is in **Therbie › Settings…**.
2. **On the iPhone or iPad:** go to the **Mac** tab and tap **Open Mac Display** on the **Your Mac** card. Allow Local Network access the first time.
If the device isn't paired with the Mac, Mac Display says **Pair With Your Mac**. If more than one Mac is sharing, choose one in Mac Display's **⋯** menu under **Mac** (or leave it on **First Mac Found**).
Up to 4 iPhones and iPads can watch one Mac at a time.
## What it shows
- **CPU** with the performance- and efficiency-core split, **memory** used of total, and **GPU** load.
- **Chips** for the thermal state, download and upload speed, battery, and Low Power Mode.
- **Live**, with a pulsing dot, while readings arrive. If the Mac goes quiet, everything greys out and shows **Last seen** with the time (for example **Last seen 10:42**) and what Mac Display is waiting for. After 30 minutes it says **Not seen for …**.
**How often it updates:** the Mac sends a reading at the device's dashboard refresh rate (**⋯ › Set refresh frequency**: 2, 5 or 10 seconds, default 5).
**Screen:** Mac Display keeps the screen on while it's showing. It shifts its layout slightly once a minute so nothing burns in, and always uses a dark design.
The **⋯** menu also has **About Mac Display** and **Stop Looking for Macs**.
## The Your Mac card and widget
- **The Your Mac card,** on the **Mac** tab, shows the Mac's CPU and four small rings, marked **Live** or with the time it was last seen.
- **The Your Mac widget** shows the last status Therbie received, with the time. Widgets can't keep a live connection, and iOS decides when they refresh. After 30 minutes without news, the widget fades and says **Not seen for …**. Open Therbie or Mac Display to bring it up to date. See [Widgets](https://irrhuh.app/therbie/guide/widgets.html).
## Privacy
- **Off until you turn it on.** Sharing is off by default.
- **Read-only.** iPhones and iPads can watch, but can't change anything on the Mac.
- **Paired devices only.** Only iPhones and iPads paired with the Mac can watch, and the readings are encrypted on the way.
- **What's sent:**
- the Mac's name, chip, model identifier and macOS version;
- its live readings: CPU (including the core groups), memory and memory pressure, GPU load, thermal state, network, battery and charging.
- **Unpairing stops it.** Unpair a device on the Mac and its Mac Display stops at once. Its Your Mac card and widget clear the next time it tries to connect.
- **No internet.** Nothing goes over the internet or through iCloud.
Others on the same network can see that the Mac is sharing, because its name is announced on the network, as AirPlay devices' names are. They can't see what it shares.
---
id: mac-app
type: screen
title: Therbie for Mac
summary: Therbie for Mac (macOS 15 or later) shows the Mac's own CPU, memory, thermal state, GPU load, battery, network and storage in the menu bar and a window. It keeps History, collects and compares results and sensor recordings from paired iPhones and iPads, and can run tests on them.
section: mac
url: "https://irrhuh.app/therbie/guide/mac-app.html"
related: [pairing, device-link, mac-display, history-insights, network-vs-activity-monitor, ios-limits]
platform: [mac]
applies_to: 1.0
updated: 2026-11-16
leads_to: [pairing, device-link, mac-display]
---
# Therbie for Mac
Therbie for Mac runs on macOS 15 or later. It has three jobs:
- **It monitors the Mac itself,** in the menu bar and in its window.
- **It collects your iPhones' and iPads' data.** Paired devices send their benchmark results, History and sensor recordings, and Therbie for Mac compares them.
- **It runs tests on paired iPhones and iPads** over your local network.
The window's sidebar has six pages: **This Mac**, **Devices**, **Runs & Compare**, **History**, **Sensors** and **Open Data**.
## Menu bar
Therbie puts a small CPU ring and percentage in the menu bar. Click it for a panel that shows:
- the Mac's name and chip;
- rings for CPU, memory, thermal state and battery (battery only on Macs that have one);
- Low Power Mode, download and upload speed, and GPU load;
- **Open Therbie** and **Quit**.
Therbie keeps reading and recording History while it's in the menu bar, even with the window closed. To hide the menu bar item, turn off **Show in menu bar** in **Therbie › Settings…**.
## This Mac
| Card | What it shows |
|---|---|
| **CPU** | Total load, and a bar per core, grouped into efficiency and performance cores on Apple silicon |
| **Memory** | App, Wired, Compressed, Cached and Free memory, plus **Memory pressure** and **Swap used** |
| **Thermal** | Normal, Warm, Hot or Critical, with what each means |
| **GPU** | Live GPU load, plus the chip, GPU cores, Metal family, memory budget per app, unified memory and hardware ray tracing |
| **Battery** | Level, state (for example *Plugged in, not charging*), Low Power Mode, and time to full or time remaining |
| **Network** | Download and upload speed, with the peak over the chart's window |
| **Storage** | Free space on the startup disk, of the total |
**Update interval** (the clock button at the top right) sets how often This Mac reads: **1 s**, **2 s** or **5 s**. The default is 2 seconds. In Low Power Mode, or when the Mac is Hot or Critical, Therbie waits at least 10 seconds. The same setting is **Update every** in **Therbie › Settings…** (⌘,).
Each card's **ⓘ** explains its numbers.
> **Note** Macs can show GPU load; iPhones and iPads can't. Therbie doesn't show temperatures or fan speeds on any device: reading them needs hardware access that App Store apps don't get. See [What iOS doesn't let apps see](https://irrhuh.app/therbie/kb/ios-limits.html).
## History
This is the same History as on iPhone, at 1-hour, 24-hour and 14-day ranges, for the Mac itself. Shaded areas are times the Mac was asleep or Therbie wasn't running. See [History and Insights](https://irrhuh.app/therbie/guide/history-insights.html).

## Runs & Compare {#runs-compare}
Every benchmark and throttle test that reaches the Mac lands here, grouped by device. Paired devices send theirs by themselves (see [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html#history-from-your-devices)). You can also import files.
The page has three tabs: **Compare**, **Quick Benchmarks** and **Imported Data**.
- **Import:** on the iPhone or iPad, tap **⋯ › Export data** and send the files to the Mac. Then drag them onto the window, or choose **Import Therbie Data…** (⌘O) or **Import…** in the toolbar. History and data usage appear under **Imported Data**.
- **Compare:** tick runs to put them on one chart. The table shows each run's peak, where it levelled off, and how much of its peak it kept at 5, 10, 15 and 20 minutes.
- **Plateau:** where a run stops changing. Choose a **Tolerance** of **±5%** (the default, suits most runs) or **±2%** (stricter; GPU runs, which wobble, may never settle at it).
- **Quick Benchmarks:** every device side by side, as **Latest run** or **Best of all runs**, with the highest value in each row highlighted.
- **Export All…** saves everything as one JSON file for your own analysis.


## Devices
The Devices page lists iPhones and iPads on your local network that have **Allow my Mac to run tests** turned on. Pair each one once. After that it shows live readings, and you can start tests on it or run a plan on several at once. See [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html) and [Testing devices from your Mac](https://irrhuh.app/therbie/guide/device-link.html).
## Sensors
The Sensors page shows the sensor recordings your paired devices have sent. Choose a **Device**, then what to **Show**:
- **Trips**
- **Vibration**
- **Sound Log**
- **Plants** (from Bluetooth plant sensors)
- **Bluetooth** (the Bluetooth survey's counts)
Some changes you make here are sent back to the device the next time it connects, such as renaming or deleting a trip. **About sensor recordings** (the **ⓘ** button) explains what syncs and the size limits.
## Open Data
The Open Data page builds a preview folder on this Mac. The folder holds summaries of your devices' synced sensor data, with privacy filters applied, showing what a public page could contain. **Nothing is uploaded.**
- **Private zones:** places your trips often start or end are treated as private zones. Nothing inside them is shown, and where they are is never written to the preview.
- **Viewing it:** **Rebuild Now**, **Open in Browser** and **Show in Finder** work on the folder.
- **Compare with Public Data** (only when you click it): downloads Changi airport's weather reports from aviationweather.gov and Singapore's air temperature feed from data.gov.sg. It uses them to compare your devices' barometer and plant-sensor readings. The requests carry no location or identifier; the nearest weather station is picked on the Mac.
## Settings
**Therbie › Settings…** (⌘,) has:
- **Open at login**;
- **Show in menu bar**;
- **Update every**;
- the switch for sharing this Mac's status (see [Mac Display](https://irrhuh.app/therbie/guide/mac-display.html));
- **Storage**.
Under **Storage**, **Keep synced data** sets how long the Mac keeps what your devices send: **Forever** (the default), or 10, 5, 2 or 1 years. Storage also lists how much space each kind of data and each device uses.
## Mac Display
The **iPhone & iPad Display** button in the This Mac toolbar shares the Mac's status with Therbie on your iPhones and iPads. See [Mac Display](https://irrhuh.app/therbie/guide/mac-display.html).
---
id: device-link
type: guide
title: Testing devices from your Mac
summary: Therbie for Mac can show a paired iPhone or iPad's live readings, start benchmarks and throttle tests on it, and work through a run plan on several devices at once. The device must have Allow my Mac to run tests on, be on the same network, and keep Therbie on screen.
section: mac
url: "https://irrhuh.app/therbie/guide/device-link.html"
related: [pairing, mac-app, benchmarks, throttle-test-length, troubleshooting]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# Testing devices from your Mac
Therbie for Mac can show the live readings of the iPhones and iPads it's paired with, and start benchmarks and throttle tests on them. A run plan tests several devices at once while you're away, for example overnight.
Pair each device first: see [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html).

## On the iPhone or iPad
1. Go to the **Mac** tab. On the **Mac Testing** card, turn on **Allow my Mac to run tests**.
2. Allow Local Network access when iOS asks. Therbie needs it to be found on your network.
3. Plug the device in and keep Therbie on screen. iOS stops tests when you leave the app.
**Screen:** while a test runs, and for 30 minutes after, Therbie keeps the screen on, so a plan's next test can start once the device has cooled. Just being connected to the Mac doesn't keep the screen on. Set Auto-Lock to Never yourself if you want it to stay on.
**Connection:** it closes shortly after Therbie leaves the screen, even with the floating monitor open. The Mac reconnects when you come back. A test that was already running carries on, and its result is sent when the Mac reconnects.
**Who can connect:** only Macs you've paired with, and everything between them is encrypted. **Paired Macs** on the Mac Testing card lists them. Tap **Remove** to unpair one.
**Low Power Mode:** a device with Low Power Mode on refuses tests from the Mac, because results wouldn't be comparable. The card says so.
## On the Mac
Open **Devices**. A device that isn't paired shows **Pair…**. A paired device connects by itself and shows:
- CPU, memory, thermal state and battery;
- when its History, benchmarks and data usage last arrived;
- buttons for **Quick Benchmark** and **Throttle Test…**.
**Throttle Test…** offers **CPU** or **GPU**, for **5**, **10** or **20** minutes, with an optional label. This differs from the device itself, which offers 5 or 15 minutes.
**The ⋯ menu on a device** has **Rename…**, and **Disconnect** while it's connected. It also has **Unpair** while it's paired. For a device that's no longer on the network, it has **Forget** (or **Unpair and Forget**). Renamed devices keep their name in Runs & Compare.
**Device names** default to the model, such as *iPad mini (A17 Pro)*. iOS doesn't give apps the name you've given your device, so use **Rename…** for your own names.
**A device's status** reads, for example, **Connected**, **Connecting…**, **Reconnecting…**, **Not on the network**, **Not paired** or **Update needed**.
## Run plans
A run plan is a list of steps that each chosen device works through at its own pace. Click **Run Plan** in the Devices toolbar.
| Step | What it does |
|---|---|
| **Wait Until Normal** | Waits until the thermal state has been Normal for a full minute. After 90 minutes it carries on with a warning |
| **Quick Benchmark** | Runs the one-minute benchmark |
| **Rest** | Waits a set number of minutes, from 1 to 120 |
| **Throttle Test** | CPU or GPU, from 1 to 60 minutes, with a label |
Add steps with **Add Step**. **Use Standard Plan** fills in this plan:
1. Wait until Normal, then a quick benchmark.
2. Rest 10 minutes, then a CPU test for 5 minutes.
3. Rest 15 minutes, wait until Normal, then a GPU test for 15 minutes.
4. Rest 15 minutes, wait until Normal, then a CPU test for 5 minutes again, to check the first run.
The app shows it as **About 1 h 7 min, plus time to cool down** per device.
- **Start:** tick the devices to include and click **Start Plan**. Every result goes to Runs & Compare. **Stop Plan** ends it.
- **The Mac stays awake** while a plan runs. Closing a MacBook's lid still sleeps it.
- **The log** records every step, refusal and disconnect, and is kept after the plan ends (up to 2,000 entries). **Copy** and **Clear** are above it.
- **If a device drops off,** the Mac waits up to 30 minutes for it to come back and carries on. After that it skips the rest of that device's plan.
- **If a device refuses a step,** for example because Low Power Mode is on or it's at Critical, the Mac tries again every minute, up to 5 times, then skips that step.
- **If a device is busy** with another test, the Mac keeps trying for up to 45 minutes.
> **Tip** An iPhone can take 20 to 30 minutes to cool back to Normal between tests, much longer than an iPad. **Wait Until Normal** handles it. See [How long should a throttle test be?](https://irrhuh.app/therbie/kb/throttle-test-length.html)
---
id: faq
type: faq
title: Frequently asked questions
summary: "Quick answers about Therbie, the system monitor for iPhone, iPad and Mac: battery use, why there are no temperatures, GPU load, per-app figures, what works in the background, what needs a Mac, and privacy."
section: kb
url: "https://irrhuh.app/therbie/kb/faq.html"
related: [ios-limits, background-limits, privacy-security, troubleshooting, support]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# Frequently asked questions
## Does Therbie have ads, an account or in-app purchases?
No. Therbie 1.0 has no ads, no account and no in-app purchases. The App Store page shows its price.
## Does Therbie drain my battery?
Not while iOS has it paused. Therbie only uses battery while it's doing something:
| When | Battery use |
|---|---|
| On screen | A reading every 5 seconds by default (2 or 10 in **⋯ › Set refresh frequency**) |
| Widgets | One quick reading each time iOS refreshes a widget |
| [Floating monitor](https://irrhuh.app/therbie/guide/floating-monitor.html) open | One reading and one small picture per second. Most of the cost is the screen being on, which you'd have anyway |
| A trip recording, or a sensor set to keep logging in the background | GPS or the microphone stays on, so battery use is high |
| Light Meter logging, AR sky view | The camera runs, so battery use is high |
Each sensor's settings say how much battery it uses.
## Why doesn't Therbie show the temperature in degrees?
iOS doesn't give apps temperatures. It gives a thermal state (Normal, Warm, Hot or Critical), the same signal iOS itself uses to decide when to slow the device down. Therbie shows that. See [Thermal states](https://irrhuh.app/therbie/kb/thermal-states.html) and [What iOS doesn't let apps see](https://irrhuh.app/therbie/kb/ios-limits.html).
## Can Therbie show GPU load on iPhone?
No. iOS doesn't share GPU load with apps. Therbie for Mac does show the Mac's GPU load, because macOS makes it available.
## Can Therbie measure one app, such as a game?
No. iOS only gives apps figures for the whole device. To see what a game does, open the floating monitor and play. The window shows the whole device's load while the game runs.
## Can Therbie keep watching after I close it?
Only while one of these is running:
- the floating monitor;
- a recording trip;
- a sensor set to **Keep logging in the background**.
Otherwise iOS pauses Therbie, as it does every app. See [Why background alarms are rare](https://irrhuh.app/therbie/kb/background-limits.html).
## Does Therbie speed up or clean my device?
No. Therbie only measures. It doesn't change how your device runs, free up memory, or cool it down.
## Do I need a Mac?
No. Everything on iPhone and iPad works on its own. A Mac adds:
- a menu bar monitor for the Mac itself;
- comparing results across devices;
- testing devices over your network;
- a long-term copy of each device's History and recordings.
See [Therbie for Mac](https://irrhuh.app/therbie/guide/mac-app.html).
## Does Therbie collect my data?
No. There's no account, no analytics and no tracking, and the developer receives nothing. Your readings stay on your devices. If you pair a Mac, your devices send their data to that Mac over your own network, encrypted. See the [privacy policy](https://irrhuh.app/therbie/privacy.html) and [Privacy and security](https://irrhuh.app/therbie/kb/privacy-security.html).
## Does Therbie use the internet?
Only for public data, and only when you tap for it:
- **GNSS Sky** downloads satellite orbits from CelesTrak when you tap **Download orbit data**;
- **Therbie for Mac** downloads public weather data when you click **Compare with Public Data** on its Open Data page.
Neither request includes your location or any identifier. The Location map comes from Apple Maps, and city search in Sun & Moon uses Apple's geocoder.
## Why are my benchmark results different from last time?
Heat, charge state, Low Power Mode and the room all change results. Start at Normal, in the same place, plugged in or not the same way each time. See [Benchmarks and throttle tests](https://irrhuh.app/therbie/guide/benchmarks.html) and [How long should a throttle test be?](https://irrhuh.app/therbie/kb/throttle-test-length.html)
## How do I get help?
Start with [Troubleshooting](https://irrhuh.app/therbie/kb/troubleshooting.html). If that doesn't cover it, see [Help and contact](https://irrhuh.app/therbie/support.html).
---
id: ios-limits
type: reference
title: What iOS doesn't let apps see
summary: iOS and iPadOS don't give apps GPU load, Neural Engine load, temperatures, fan speeds or per-app CPU use, and may give the battery level only in 5% steps. Therbie shows what is available, including GPU load on the Mac, and says plainly where a number isn't.
section: kb
url: "https://irrhuh.app/therbie/kb/ios-limits.html"
related: [thermal-states, battery, background-limits, faq]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# What iOS doesn't let apps see
iOS and iPadOS share only certain system figures with apps, and every system monitor on the App Store has the same limits. Therbie shows everything that's available and says plainly where a number isn't.
| Reading | iPhone and iPad | Mac | Why |
|---|---|---|---|
| CPU load, total and per core | Yes | Yes, grouped into performance and efficiency cores | Shared with every app |
| Memory in use, by kind | Yes | Yes, plus memory pressure and swap | Shared with every app |
| Thermal state (Normal to Critical) | Yes | Yes | Shared with every app |
| GPU load | No | Yes | iOS doesn't expose it; macOS's graphics driver reports it |
| Neural Engine load | No | No | Not exposed on either. The quick benchmark measures its speed instead |
| Temperature in °C | No | No | Needs hardware access that App Store apps don't get |
| Fan speed | Not applicable | No | Same as temperature |
| CPU use per app | No | No | iOS doesn't let one app measure another |
| Battery level | Often in 5% steps | Exact | See [Battery readings](https://irrhuh.app/therbie/kb/battery.html) |
| Charging power in watts | Estimated only | Not shown | iOS doesn't share it. See [Battery readings](https://irrhuh.app/therbie/kb/battery.html) |
| Which GPS satellites are in use | No | Not applicable | Therbie predicts where satellites are instead. See [GNSS sky plot (predicted)](https://irrhuh.app/therbie/guide/sensors-satellites.html) |
| The ambient light sensor | No | Not applicable | The Light Meter estimates brightness from the camera instead. See [Light meter](https://irrhuh.app/therbie/guide/sensors-light.html) |
| Monitoring in the background | Only while the floating monitor is open, a trip records, or a sensor keeps logging in the background | Yes | iOS pauses apps you leave. See [Why background alarms are rare](https://irrhuh.app/therbie/kb/background-limits.html) |
| The name you gave the device | No | Yes | Therbie for Mac shows a device's model name, such as *iPad mini (A17 Pro)*; use **Rename…** for your own names |
## The CPU, GPU and Neural Engine share one budget
On Apple silicon, the CPU, GPU and Neural Engine sit on one chip and share its memory and its heat budget. So even without GPU or Neural Engine figures, a busy game or on-device AI shows up as heat and as memory use. The thermal state tells you when the chip is being held back.
## Apps that claim more
Some apps show a temperature or a "GPU %" on iPhone. iOS doesn't give App Store apps those readings, so such numbers are estimates or relabelled thermal states. Therbie shows the four thermal states iOS reports, and explains what each means. See [Thermal states](https://irrhuh.app/therbie/kb/thermal-states.html).
---
id: thermal-states
type: concept
title: Thermal states
summary: iOS, iPadOS and macOS report heat as one of four thermal states, not a temperature. Therbie shows them as Normal, Warm, Hot and Critical. At Hot the system reduces performance; at Critical it throttles heavily.
section: kb
url: "https://irrhuh.app/therbie/kb/thermal-states.html"
related: [ios-limits, alerts, benchmarks, throttle-test-length, glossary]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# Thermal states
iOS, iPadOS and macOS report heat to apps as one of four levels, called thermal states, rather than as a temperature. Each level tells you how much the system is doing to cool down, which matters more for performance than the exact degrees.
| System's name | Therbie shows | What it means (the app's own wording) |
|---|---|---|
| Nominal | **Normal** (**OK** in the rings and widgets) | Running cool. No performance limits |
| Fair | **Warm** | Slightly warm. iOS may start trimming background work |
| Serious | **Hot** | iOS is reducing performance and may dim the screen |
| Critical | **Critical** | Very hot. iOS is heavily throttling; let it cool down |
## What raises it
Long games, video recording, on-device AI, fast charging, a thick case, sun and a warm room all raise the thermal state. In the developer's throttle tests, a room 2 °C warmer changed results more than taking a case off did. See [How long should a throttle test be?](https://irrhuh.app/therbie/kb/throttle-test-length.html)
## What Therbie does at each level
- **Hot or Critical:** Therbie reads less often (at least every 10 seconds on the dashboard, every 5 seconds in the floating monitor) to add as little heat as possible.
- **Critical:** a running throttle test stops, and a new one won't start.
## "Normal" doesn't mean fully cool
The thermal state can drop back to Normal while the inside of the device is still warm. Before a benchmark, Therbie checks History. If the device was Warm or under test in the last 10 minutes, it shows a **Leftover heat** notice with how long to wait for a fair result.
## Hot alerts
Turn on the **Hot** alert in **⋯ › Alerts** to be notified when the device reaches Hot or Critical while Therbie is running. See [Alerts](https://irrhuh.app/therbie/guide/alerts.html).
---
id: memory
type: concept
title: Memory, explained
summary: A full memory bar is normal on iPhone, iPad and Mac. Therbie counts "in use" as App + Wired + Compressed memory and leaves out Cached memory, which the system frees instantly. The real signs of running short are apps reloading and, on a Mac, memory pressure.
section: kb
url: "https://irrhuh.app/therbie/kb/memory.html"
related: [dashboard, alerts, glossary, mac-app]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# Memory, explained
A full memory bar is normal. iOS, iPadOS and macOS all try to use every gigabyte, because empty memory does nothing. Keeping recent apps and files in memory makes switching back to them instant.
Therbie counts memory **in use** as **App + Wired + Compressed**. Cached memory is left out, because the system frees it the moment an app needs it. The same definition is used on the Memory card, in the **High memory** alert and in the **Get Memory Usage** Shortcuts action.
## What the colours mean
| Colour | Kind | Meaning |
|---|---|---|
| Blue | **App** | Memory apps and the system are actively using for their own data |
| Orange | **Wired** | Locked in place for the system's core. It can't be compressed or freed |
| Purple | **Compressed** | Data squeezed to take less space instead of being thrown away. Unpacking it is fast, but costs a little CPU |
| Teal | **Cached** | Copies of files and data that can be dropped instantly if an app needs the room. Think of it as free memory doing something useful |
| Grey | **Free** | Truly unused. Usually small, by design |
## When memory runs low
- **iPhone:** there's no swap. iOS drops cached data first, then compresses memory, then quietly closes apps in the background. They reload when you go back to them.
- **iPad:** works like iPhone. iPads with M-series chips can also swap memory to storage.
- **Mac:** compresses first, then swaps to the SSD. Therbie for Mac shows **Memory pressure** and **Swap used**. Pressure is the best single sign of whether the Mac needs more memory.
## Unified memory
On Apple silicon, the CPU, GPU and Neural Engine share one pool of memory. Games, video editing and on-device AI draw from the same memory as your apps.
## What to watch
Don't worry about the in-use number on its own. The real signs of running short are:
- apps reloading when you switch back to them;
- a Compressed amount that keeps rising while you work;
- on a Mac, memory pressure at Warning or Critical.
The **High memory** alert can tell you when use passes a level you choose. See [Alerts](https://irrhuh.app/therbie/guide/alerts.html).
---
id: battery
type: concept
title: Battery readings
summary: Many iPhones and iPads give apps the battery level only in 5% steps, so Therbie marks those readings with ≈ and they can differ from the status bar. Charging watts are an estimate. Apps can't read or change the charge limit or Low Power Mode.
section: kb
url: "https://irrhuh.app/therbie/kb/battery.html"
related: [dashboard, alerts, benchmarks, glossary]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# Battery readings
On many iPhones and iPads, iOS gives apps the battery level only in 5% steps. Therbie marks those readings with **≈**, and they can differ from the status bar's percentage by a few points. On a Mac, the battery level is exact.
## How Therbie knows
Therbie treats a device's battery readings as approximate until it has seen three different levels that aren't on a 5% step, for example 73%, 81% and 92%. After that, it shows single percents without the **≈**.
## Why the level can look stuck
iOS can keep handing apps an old battery level while charging. Therbie asks iOS for a fresh reading every 20 seconds. Even so, with 5% steps, a level that doesn't move for ten minutes while charging is normal.
## Charging speed and watts
iOS doesn't tell apps the real charging power. Therbie measures how fast the level rises and combines it with a typical battery size for the device model. The watts shown are a rough guide, marked with **≈**.
Below 80%, a reading under about 7.5 W makes Therbie show **Charging slowly**. That usually means a low-power charger (a monitor's USB-C port, for example), a worn cable, or a hot or busy device. For a proper measurement, use the **Charger Test** on the Benchmark screen; see [Benchmarks and throttle tests](https://irrhuh.app/therbie/guide/benchmarks.html).
## Charge limits and "holding"
- **iPhone 15 and later:** **Settings › Battery › Charging** sets a limit from 80% to 100%.
- **Other iPhones:** Optimised Battery Charging learns your routine and may hold at 80% until you need it.
- **iPad:** options vary by model.
On devices that report single percents, Therbie shows **Charging is holding at …%** when the level hasn't moved for 10 minutes while plugged in, at about 80% or above.
## What apps can't do
Apps can't:
- read or change the charge limit;
- turn Low Power Mode on or off;
- open the Battery page in Settings.
So Therbie tells you where to find each.
## Low Power Mode
The quickest way to turn it on is the Control Center control: open Control Center, tap **+**, then **Add a Control**, and choose **Low Power Mode**. A Shortcuts automation with the **Set Low Power Mode** action can also turn it on at a battery level you choose.
In Low Power Mode:
- **Benchmarks run slower,** and Therbie warns you.
- **Therbie reads less often,** at least every 10 seconds, to save energy.
- **The Mac won't start tests** on a device that has it on. See [Testing devices from your Mac](https://irrhuh.app/therbie/guide/device-link.html).
---
id: network-vs-activity-monitor
type: concept
title: Why Therbie's network speed differs from Activity Monitor
summary: On a Mac, Activity Monitor adds up what every app sends and receives, including traffic between apps on the same Mac, counted at both ends. Therbie counts only bytes that cross Wi-Fi, Ethernet or cellular, and skips VPN tunnels, so its figures are often lower. Both are correct.
section: kb
url: "https://irrhuh.app/therbie/kb/network-vs-activity-monitor.html"
related: [mac-app, data-usage, glossary]
platform: [mac, iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Why Therbie's network speed differs from Activity Monitor
On a Mac, Activity Monitor's network figures are often higher than Therbie's. They measure different things, and both are correct.
## What each one counts
| | Activity Monitor | Therbie |
|---|---|---|
| What it adds up | What each app sends and receives | Bytes that cross a network interface: Wi-Fi or Ethernet (and cellular on iPhone and iPad) |
| Traffic between apps on the same Mac | Counted, at both ends | Not counted |
| VPN tunnels | Counted as well as the Wi-Fi traffic carrying them | Skipped, so encrypted traffic isn't counted twice |
Traffic between apps on the same Mac includes simulators, Android emulators, local development servers and other developer tools. On a Mac running these, Activity Monitor can show far more traffic than ever crossed the network.
## Short bursts
Each reading is an average over the update interval. A one-second burst at 5 MB/s shows as about 2.5 MB/s at a 2-second interval.
- **The default on the Mac** is a reading every 2 seconds.
- **To see bursts more clearly,** choose **1 s** in **Update interval** (the clock button at the top right of This Mac).
- **Peaks:** the Network card's chart labels its top line with the actual peak. The line under it gives the peak download and upload over the chart's window, which covers the last 120 readings.
## On iPhone and iPad
The same rule applies. Therbie counts Wi-Fi and cellular. It doesn't count VPN tunnels or Personal Hotspot traffic again, because that traffic already passes through Wi-Fi or cellular. See [How data usage is counted](https://irrhuh.app/therbie/kb/data-usage.html).
---
id: data-usage
type: concept
title: How data usage is counted
summary: Therbie adds up Wi-Fi and cellular traffic by day from iOS's byte counters, groups it into billing cycles that start on a day you set, and keeps about 13 months. It can miss traffic after a restart or between rare readings. The figures are estimates, not your carrier's records.
section: kb
url: "https://irrhuh.app/therbie/kb/data-usage.html"
related: [dashboard, history-insights, widgets, network-vs-activity-monitor]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# How data usage is counted
Therbie on iPhone and iPad totals your Wi-Fi and cellular data by day. iOS keeps a running byte count for each network connection. Therbie reads it whenever it takes a reading (in the app, the floating monitor or a widget), and adds what's new to that day's Wi-Fi or cellular total.
The totals are shown on the **Data Usage** card on the **Device** tab.
## Billing cycles
Set the day your carrier's billing cycle starts in the Data Usage card's **ⓘ** sheet, under **Billing cycle starts on**. Therbie groups daily totals into cycles and keeps about 13 months (400 days) on the device. In shorter months, a cycle set to start on the 31st starts on the last day of the month.
## Starting again from zero
To clear the totals, for example to line them up with a new plan, open the Data Usage card's **ⓘ** sheet and tap **Reset Data Usage**. Totals start again from the next reading. Your carrier's figures aren't affected.
## What's counted
| Connection | Counted? |
|---|---|
| Wi-Fi | Yes |
| Cellular | Yes |
| Personal Hotspot | Shown as **Hotspot**. It also passes through cellular, so it's already part of the cellular total, not extra |
| VPN | Not counted again: the traffic is already counted on Wi-Fi or cellular |
## What can be missed
- **Restarts:** restarting the device resets iOS's counters, so anything since Therbie's last reading is lost.
- **Long gaps:** very large downloads between readings can be undercounted. Keep a Therbie widget on a screen you visit often for more frequent readings.
- **Wi-Fi-only iPads** have no cellular connection, so the card shows only Wi-Fi.
> **Important** These figures are estimates for your information. They aren't a substitute for your carrier's records or a basis for billing disputes.
---
id: throttle-test-length
type: concept
title: How long should a throttle test be?
summary: Five minutes for the CPU and fifteen for the GPU. In the developer's 20-minute tests on an iPhone 17 Pro, iPad Air and iPad mini (5 November 2026), CPU speed settled within about 4 minutes and GPU speed within 10 to 15. Running to 20 minutes added nothing.
section: kb
url: "https://irrhuh.app/therbie/kb/throttle-test-length.html"
related: [benchmarks, device-link, thermal-states, glossary]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# How long should a throttle test be?
Five minutes for the CPU and fifteen for the GPU. Those are the two lengths Therbie offers on iPhone and iPad. They come from 20-minute tests the developer ran on three devices overnight, and again the next afternoon.
## How the tests were run
- **When:** 5 November 2026.
- **Devices:** an iPad Air (A14), an iPad mini (A17 Pro) and an iPhone 17 Pro.
- **Method:** a run plan from Therbie for Mac. Each device ran a CPU test, a GPU test and a repeat CPU test, 20 minutes each, with rests in between.
- **Builds:** debug builds, which understate raw CPU speed. The % kept is relative to each run's own peak, so it isn't affected.
These are one set of measurements on three devices. Your device and room will give different numbers.
## The overnight runs
The table shows how much of its peak speed each device was still holding at each point. "Settled" is when the run stayed within ±5% of its final level.
| Run | Settled (±5%) | 5 min | 10 min | 15 min | 20 min |
|---|---|---|---|---|---|
| iPad Air (A14) · CPU | 1 min 10 s | 85% | 84% | 83% | 84% |
| iPad mini (A17 Pro) · CPU | 30 s | 75% | 75% | 75% | 75% |
| iPhone 17 Pro · CPU | 3 min 10 s | 79% | 78% | 79% | 78% |
| iPad Air (A14) · GPU | From the start | 100% | 100% | 100% | 100% |
| iPad mini (A17 Pro) · GPU | 11 min 9 s | 68% | 64% | 68% | 67% |
| iPhone 17 Pro · GPU | 10 min 17 s | 72% | 68% | 73% | 73% |
- **CPU:** every device settled within 4 minutes. The 5-minute figure matched the 20-minute one to within 1 to 4 points, and the repeat runs agreed.
- **GPU:** the two newer chips dipped and recovered for 10 to 15 minutes before settling. The older iPad Air's GPU never slowed at all.
## The room mattered more than the case
The same tests ran again in the afternoon with cases removed, in a room about 2 °C warmer (25 °C instead of 23 °C). Every device kept less of its peak:
| Device | CPU at 5 min, overnight → afternoon | GPU at 15 min, overnight → afternoon |
|---|---|---|
| iPad Air (A14) | 85% → 80–83% | 100% → 89% |
| iPhone 17 Pro | 79–81% → 72–74% | 73% → 63% |
| iPad mini (A17 Pro) | 75–76% → 66–69% | 68% → 65% |
Lying flat on a desk also traps heat against the back of the device, where these devices shed most of it. A keyboard case or stand that lets air reach the back helps.
> **Tip** For fair comparisons, test in the same room, at the same time of day, in the same position, and label each run with its setup.
## Cooling time
Between tests, the iPhone took 18 to 31 minutes to return to Normal; the iPads took about a minute. Plan runs on iPhones with long rests, or let the run plan's **Wait Until Normal** step handle it. See [Testing devices from your Mac](https://irrhuh.app/therbie/guide/device-link.html).
## Other lengths on the Mac
Therbie for Mac's **Throttle Test…** sheet also offers 10 and 20 minutes, and a run plan's throttle step can run from 1 to 60 minutes.
---
id: background-limits
type: concept
title: Why background alarms are rare
summary: iOS pauses apps a few seconds after you leave them, so no app can keep watching the battery or thermal state in the background on its own. Therbie keeps watching only while it's on screen, while the floating monitor is open, or while a trip or sensor keeps it running.
section: kb
url: "https://irrhuh.app/therbie/kb/background-limits.html"
related: [alerts, floating-monitor, widgets, ios-limits]
platform: [iphone, ipad]
applies_to: 1.0
updated: 2026-11-16
---
# Why background alarms are rare
On iPhone and iPad, a monitoring app can't keep watching the battery or the thermal state after you leave it. iOS pauses the app within seconds. That's why a "charge complete" alarm is hard to build, and why Therbie's [Alerts](https://irrhuh.app/therbie/guide/alerts.html) work only while Therbie is running.
## What iOS does
- **Apps you leave are paused within seconds.** A paused app can't read the battery, and iOS stops sending it battery updates.
- **Background modes are for their stated purpose only.** iOS lets an app keep running for specific jobs, such as playing audio, navigation, or Picture in Picture. Apple's App Review Guidelines (section 2.5.4) allow these modes only for their intended purpose. An app that plays silent audio just to stay awake breaks that rule.
## When Therbie keeps running
Therbie keeps running in the background only while one of its features genuinely needs it:
| Feature | What it keeps doing | How often it reads CPU, memory, heat and battery |
|---|---|---|
| [Floating monitor](https://irrhuh.app/therbie/guide/floating-monitor.html) open | Updates the window, records History, checks alerts | Every second (every 5 seconds in Low Power Mode or when Hot) |
| A trip recording | Records the trip, plus History and alerts | Every 10 seconds |
| A sensor with **Keep logging in the background** on (Location or Sound Level) | Logs that sensor, plus History and alerts | Every 10 seconds |
When none of these is running, iOS pauses Therbie like any other app.
## What fills the gaps
- **Widgets:** each time iOS refreshes a Therbie widget, the widget takes a reading and saves it to History. iOS decides when that happens. Apple's WidgetKit documentation says a widget people look at often gets roughly a refresh every 15 to 60 minutes. See [Widgets](https://irrhuh.app/therbie/guide/widgets.html).
- **Shortcuts:** for an alarm that works with Therbie closed, use a Shortcuts automation built into iOS: **Automation › New › Battery Level › Rises Above 80%**, then **Show Notification**. See [Shortcuts and Siri](https://irrhuh.app/therbie/guide/shortcuts-siri.html).
---
id: privacy-security
type: reference
title: Privacy and security
summary: Therbie keeps readings on the device that recorded them. Data moves only to a Mac you've paired, encrypted with ChaCha20-Poly1305 over your local network, or in files you share yourself. The only internet requests are for public data, made when you tap for them. This page lists what crosses the network and what others on the same network can see.
section: kb
url: "https://irrhuh.app/therbie/kb/privacy-security.html"
related: [privacy, pairing, mac-display, device-link, support]
platform: [iphone, ipad, mac, watch]
applies_to: 1.0
updated: 2026-11-16
---
# Privacy and security
Therbie has no account, no analytics, no ads and no tracking, and the developer receives none of your data. See the [privacy policy](https://irrhuh.app/therbie/privacy.html). Readings, History, benchmark results, data usage and sensor recordings stay on the device that recorded them, except in the cases listed below.
## What leaves the device
Only what you turn on or ask for:
| Feature | Off by default? | What's sent, and to whom |
|---|---|---|
| **Allow my Mac to run tests** (iPhone, iPad) | Yes | To your paired Mac only, over your local network, encrypted. Sent: the device's model and iOS version, live readings, test results, History, benchmark results, data usage, trips with their routes, vibration sessions, the sound log, Bluetooth plant-sensor readings, Bluetooth survey counts and datapoint counts |
| Changes made on the Mac (Mac to device) | Only with a paired device | Renames, deletions and some settings you change on the Mac's Sensors page, sent back to the device |
| **Share this Mac's status** (Mac) | Yes | To your paired iPhones and iPads only, encrypted and read-only. Sent: the Mac's name, chip, model identifier, macOS version and live readings |
| **Download orbit data** (GNSS Sky, iPhone and iPad) | Nothing downloads until you tap | A request to celestrak.org for public satellite orbits. No location or identifier |
| **Compare with Public Data** (Open Data, Mac) | Nothing downloads until you click | Requests to aviationweather.gov and data.gov.sg for public weather data. No location or identifier |
| Map and city search (Location, Sun & Moon) | Only while you use them | Apple Maps downloads map images; city search sends the name you type to Apple's geocoder |
| Apple Watch app | Only while you use it | Between your Apple Watch and your iPhone, through Apple's watch connection: trip controls, heart rate for a trip, Logger recordings |
| **Export data**, **Share …** buttons | You choose where to send it | Files you share yourself |
iOS and macOS ask for **Local Network** access the first time a feature needs it.
## Pairing and encryption
A Mac has to be paired before it can connect to an iPhone or iPad. Both screens show the same 6-digit code, and you tap **Allow** on the device. See [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html).
- **Someone else on the network can't connect.** Without your tap on the device they can't pair. A Mac pretending to be yours can't prove it holds the pairing key.
- **They can't read the traffic.** After pairing, everything between your Mac and the device is encrypted with ChaCha20-Poly1305. Each connection gets fresh keys, with a separate key for each direction. A message that has been changed, repeated or reordered is rejected, and the connection closes.
- **The pairing key stays on the device.** It's kept in the Keychain, on that device only, and doesn't sync through iCloud Keychain.
## What others on the same network can see
Devices on a network announce themselves so others can find them, as AirDrop and AirPlay devices do. Therbie uses Bonjour for this:
| What's announced | When | Shows |
|---|---|---|
| An iPhone or iPad | While **Allow my Mac to run tests** is on | The device's model name, such as *iPad mini (A17 Pro)* |
| A Mac | While **Share this Mac's status** is on | The Mac's computer name |
When a device or Mac first connects, it also sends its name and model before encryption starts. Someone else on the network can learn the same names from the announcements. They can't see any readings or data.
## Built to resist bad input
Therbie checks every message that arrives over the network and every file it imports:
- **Size limits:** messages are capped at 16 KB before a connection is authenticated and 8 MB after.
- **Connection limits:** at most 4 connections can be waiting at once, and an address that fails repeatedly is locked out for a while.
- **Range checks:** values are kept within sensible ranges.
So a faulty or hostile device can't crash Therbie or overwrite your data.
## Where data is kept
| Device | What's kept | For how long |
|---|---|---|
| iPhone, iPad | History | 14 days |
| iPhone, iPad | Data usage | About 13 months |
| iPhone, iPad | Sound log, Bluetooth plant-sensor readings | 30 days |
| iPhone, iPad | Benchmark results | The latest 100 quick benchmarks and 100 throttle tests |
| iPhone, iPad | Trips, sessions, scans | Until you delete them |
| Mac | What paired devices send | **Forever** by default. Change it in **Therbie › Settings… › Storage › Keep synced data** |
Deleting Therbie from a device deletes what it kept on that device. A paired Mac keeps its copy until you delete it there. Device backups made by iOS can include Therbie's data, like any app's.
---
id: troubleshooting
type: troubleshooting
title: Troubleshooting
summary: Fixes for common Therbie problems. The Mac can't find an iPhone or iPad, pairing fails, Mac Display says Not seen, a widget shows an old reading, alerts don't appear, a test stops by itself, a sensor won't turn on, and Siri doesn't respond.
section: kb
url: "https://irrhuh.app/therbie/kb/troubleshooting.html"
related: [pairing, device-link, mac-display, widgets, alerts, faq, support]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# Troubleshooting
Fixes for common problems with Therbie on iPhone, iPad and Mac. If yours isn't here, see [Help and contact](https://irrhuh.app/therbie/support.html).
## The Mac doesn't see my iPhone or iPad
1. On the device, go to the **Mac** tab and check that **Allow my Mac to run tests** is on, on the **Mac Testing** card.
2. Keep Therbie on screen on the device. The connection closes shortly after Therbie leaves the screen, even with the floating monitor open. The Mac then shows the device greyed out or as **Not on the network**.
3. Both must be on the same network. Guest networks and some office networks stop devices seeing each other.
4. Check that Therbie is allowed in **Settings › Privacy & Security › Local Network** on the device, and in **System Settings › Privacy & Security › Local Network** on the Mac.
5. After updating Therbie on the device, open it again: updating closes it.
## The Mac shows "Not paired" for a device that was paired
The pairing was removed on one side: on the device under **Paired Macs**, or on the Mac with **Unpair**. A restored or new device also needs to pair again. Click **Pair…** and tap **Allow** on the device. See [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html).
## The device never shows the pairing request
- **Therbie isn't on screen.** It has to be on screen on the device, with **Allow my Mac to run tests** on. A device in the background answers "Open Therbie on the device to pair."
- **A request was just declined or ignored.** After **Don't Allow**, or a request nobody answered, the device ignores new requests for 30 seconds.
- **The request timed out.** It waits about a minute. Click **Pair…** again.
## The Mac says "Can't share right now"
This message appears on the Mac, under the **Share this Mac's status** switch. It means macOS refused to let Therbie announce itself on the network. Therbie retries every few seconds.
1. Open **System Settings › Privacy & Security › Local Network** and make sure Therbie is allowed.
2. Switch sharing off and on again.
3. If it persists, restart the Mac.
If Local Network access is turned off, the Mac says so instead: "Therbie can't use the local network."
## Mac Display says "Pair With Your Mac"
The Mac is sharing its status, but this iPhone or iPad isn't paired with it, or the pairing was removed on the Mac. Pair them: see [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html). Mac Display connects by itself once they're paired.
## Mac Display or the Your Mac card says "Not seen"
- Check that **Share this Mac's status with my iPhone and iPad** is on (the **iPhone & iPad Display** button on the Mac's This Mac page), and that the Mac is awake.
- Make sure the iPhone or iPad is on the same network as the Mac.
- If you tapped **Stop Looking for Macs**, open Mac Display again to start looking.
- Up to 4 devices can watch one Mac at a time.
## A widget shows an old reading
iOS decides when widgets refresh, and refreshes them less often on low battery. The widget's **Updated** time shows how old the reading is; after 30 minutes it turns to **Updated … ago**. Leaving Therbie refreshes all widgets. See [Widgets, Lock Screen and StandBy](https://irrhuh.app/therbie/guide/widgets.html).
## Alerts don't appear
- **Therbie isn't running.** Alerts only fire while Therbie is on screen, the floating monitor is open, or a trip or background logging keeps it running. See [Why background alarms are rare](https://irrhuh.app/therbie/kb/background-limits.html).
- **Notifications are off for Therbie.** The Alerts sheet then shows **Turn On in Settings**.
- **The level was already passed.** An alert fires when a reading *reaches* its level. If the battery was already past the level when Therbie started watching, the alert waits for it to drop and rise again.
- **The same alert fired recently.** It doesn't repeat within 10 minutes.
- **To check notifications work,** tap **Send Test Alert**.
## A test stopped by itself
On the iPhone or iPad, a benchmark or throttle test stops if:
- **you leave Therbie.** iOS doesn't allow tests in the background;
- **the device reaches Critical.**
A test started from the Mac keeps running if the Mac disconnects, and its result is sent when they reconnect. A device in Low Power Mode refuses tests from the Mac: "Low Power Mode is on. It caps performance, so results wouldn't be comparable." Check the run plan's log on the Mac for the reason.
## My results are lower than last time
Start at Normal, in the same room and position, with the same charge state. These all lower results:
- heat left over from an earlier test;
- a warmer room;
- Low Power Mode;
- a debug build from Xcode.
See [How long should a throttle test be?](https://irrhuh.app/therbie/kb/throttle-test-length.html)
## A sensor won't turn on
- **The tile says "Not on this device".** The device doesn't have that sensor, for example a barometer or step counting on some iPads.
- **The Sensors screen says "Not allowed. Change it in Settings › Therbie."** You declined a permission (Location, Microphone, Camera, Motion & Fitness or Bluetooth). Turn it on in **Settings › Therbie**.
- **Sensors only run while Therbie is on screen,** unless a trip is recording or the sensor has **Keep logging in the background** on.
## Siri doesn't respond
- Every Therbie phrase includes "in Therbie", for example "How hot is my phone in Therbie".
- If holding the side button doesn't open Siri, search Settings for "side button".
- You can also run the actions from Spotlight, the Shortcuts app or the Action Button. See [Shortcuts and Siri](https://irrhuh.app/therbie/guide/shortcuts-siri.html).
---
id: glossary
type: glossary
title: Glossary
summary: "The names Therbie uses, defined: thermal state, kept % of peak, plateau, GFLOPS, tokens per second, performance and efficiency cores, memory pressure, swap, floating monitor, History, pairing, run plan, and more."
section: kb
url: "https://irrhuh.app/therbie/kb/glossary.html"
related: [thermal-states, memory, benchmarks, pairing]
platform: [iphone, ipad, mac]
applies_to: 1.0
updated: 2026-11-16
---
# Glossary
The terms Therbie uses in the app and in this help site.
## Billing cycle
The monthly period your mobile carrier counts data in. In Therbie it starts on the day you set in the Data Usage card's ⓘ sheet. See [How data usage is counted](https://irrhuh.app/therbie/kb/data-usage.html).
## Debug build
A build of Therbie installed from Xcode for development. Its CPU benchmark results are lower than a release build's, and the Benchmark screen says so.
## Floating monitor
Therbie's small Picture in Picture window that shows live readings over other apps, with a matching Live Activity. See [Floating monitor](https://irrhuh.app/therbie/guide/floating-monitor.html).
## GFLOPS
Billions of floating-point operations (calculations) per second. Therbie uses it for the CPU's matrix maths and the GPU test. Higher is faster.
## History
Therbie's on-device record of CPU, memory, thermal state, battery and network, plus any sensors that are on. It's kept for 14 days on iPhone and iPad. See [History and Insights](https://irrhuh.app/therbie/guide/history-insights.html).
## Insights
Short findings Therbie works out from History, for today and this week, such as time spent Warm or the busiest hours.
## Kept % of peak
A throttle test's result: the average speed over the last 30 seconds, divided by the best 10-second reading. 100% means no slowdown.
## Leftover heat
Warmth still inside the device after the thermal state has returned to Normal. Therbie warns about it before a benchmark if the device was Warm or under test in the last 10 minutes.
## Mac Display
A full-screen view of your Mac's status on a paired iPhone or iPad. See [Mac Display](https://irrhuh.app/therbie/guide/mac-display.html).
## Mac Testing
The card on the iPhone or iPad's **Mac** tab with **Allow my Mac to run tests**. It lets a paired Mac see the device's readings, run tests and collect its data. See [Testing devices from your Mac](https://irrhuh.app/therbie/guide/device-link.html).
## MB/s, GB/s
Megabytes or gigabytes moved per second. Used for hashing, compression, memory copy and storage speed.
## Memory pressure
macOS's own measure of whether memory is running short: Normal, Warning or Critical. Shown on the Mac only.
## Pairing
Linking an iPhone or iPad to Therbie for Mac once, by comparing a 6-digit code and tapping **Allow** on the device. Paired devices connect by themselves, encrypted. See [Pair your Mac and devices](https://irrhuh.app/therbie/guide/pairing.html).
## Performance and efficiency cores
Apple silicon chips have fast cores for heavy work and frugal cores for light work. The Mac app shows them in separate groups.
## Plateau
The point after which a throttle test's speed stops changing, within a tolerance (±5% or ±2%) of its final level.
## Run plan
A list of test steps that Therbie for Mac runs on one or more paired devices, for example overnight.
## Swap
Memory moved out to storage when RAM runs short. Macs and iPads with M-series chips can swap; iPhones can't.
## Thermal state
The system's heat level, reported as one of four steps instead of a temperature: Normal, Warm, Hot or Critical. iOS calls them Nominal, Fair, Serious and Critical. See [Thermal states](https://irrhuh.app/therbie/kb/thermal-states.html).
## Throttling
The system lowering speed to manage heat or power.
## Tokens per second
How fast on-device AI reads a prompt or writes an answer. A token is a piece of a word.
## Trip
A recording of a walk, run, hike, ride or drive made with the Location sensor, with its route, distance, speed and climbing. See [Location and trips](https://irrhuh.app/therbie/guide/sensors-location.html).
## Unified memory
One pool of memory shared by the CPU, GPU and Neural Engine on Apple silicon.
---
id: privacy
type: legal
title: Privacy policy
summary: Therbie collects no personal data. Readings stay on your devices or go, encrypted, to a Mac you've paired. Therbie's only internet requests are for public data (satellite orbits, and weather data on the Mac), made when you tap for them, and they carry no personal data.
section: legal
url: "https://irrhuh.app/therbie/privacy.html"
related: [privacy-security, support, pairing]
platform: [iphone, ipad, mac, watch]
applies_to: 1.0
updated: 2026-11-16
---
# Privacy policy
*Last updated 16 November 2026*
Therbie is an app for iPhone, iPad, Mac and Apple Watch that shows how hard a device is working and how warm it is, and turns its sensors into measuring tools. This policy covers the apps and this help website.
In short: **Therbie collects no personal data.** It has no account, no analytics, no ads and no tracking, and we (the developer) never receive your readings.
Your data stays on your devices. It leaves them only in three ways:
- to a Mac you've paired, encrypted, over your own local network;
- in files you choose to share;
- in the public-data requests described below, which contain no personal data.
## What stays on your devices
Therbie reads system figures such as CPU and memory load, thermal state, battery level, network counters and storage. It keeps the following in its own storage on the device that recorded them:
| What | How long |
|---|---|
| History of those figures | 14 days |
| Data-usage totals | About 13 months |
| Benchmark and throttle-test results | The latest 100 of each |
| Charger tests, trips, sessions and scans | Until you delete them |
| The sound log, Bluetooth plant-sensor readings and the Bluetooth survey | 30 days |
| Your settings | Until you change them |
We never receive any of it. Deleting Therbie from a device deletes what it kept on that device. Like any app's data, it can be included in the device backups that iOS makes.
## Sensors and tools
Sensors are off until you turn them on in Therbie. While one is on, Therbie reads it while Therbie is on screen, and also in the background in these cases:
- a trip is recording;
- you've turned on **Keep logging in the background** for that sensor;
- a Bluetooth plant sensor is being listened to.
What a sensor logs is kept on your device, like the readings above.
- **Vibration** (motion sensors, no permission needed): acceleration, tilt, rotation, compass heading and magnetic field. Logged: average and peak vibration, and the vibration sessions you record.
- **Sound Level** (microphone, with your permission):
- **What it measures:** the sound level and how loud each pitch is.
- **No audio:** sound is never recorded or stored. Each moment is turned into a level and dropped.
- **Logged:** average and peak level, and a daily file of levels in 26 frequency bands, kept 30 days. **Log frequency bands** is on by default and can be turned off.
- **Identify sounds** (off by default): Apple's on-device sound classifier names the kind of sound heard, such as traffic or voices. Only the names are kept.
- **In the background:** if you turn on background logging, or a trip records while Sound Level is on, it keeps measuring while Therbie is off screen, and iOS shows the microphone indicator.
- **Location** (with your permission, While Using):
- **What it reads:** position, speed, altitude and heading, and the trips you record.
- **Logged:** speed and distance in History. Trips are kept with their routes.
- **Where it goes:** your location goes to a Mac you've paired (trips), and in a GPX file you export yourself. Otherwise it doesn't leave the device.
- **The map** is drawn by Apple Maps, which downloads map images for the area you're looking at; Apple's privacy policy covers that.
- **In the background:** a recording trip, or background logging if you turn it on, keeps going while Therbie is off screen, and iOS shows the location indicator.
- **Barometer** (Motion & Fitness, with your permission): air pressure and altitude, for the weather trend, altitude and floors. Logged: pressure and floors climbed. To correct the daily pressure tide, it keeps a rough position (rounded to about 11 km) on the device.
- **Activity** (Motion & Fitness, with your permission): steps, distance, floors, pace, cadence and the kind of activity (walking, running, cycling, driving, still), as iOS reports them. Logged: steps. On iPhone and iPad, Therbie doesn't use HealthKit.
- **Light Meter and Light Flicker** (camera, with your permission): how bright the light is, and how much it flickers. Only each video frame's exposure and brightness are used, then the frame is dropped at once. **No photo or video is taken, stored or sent.** Logged: lux (Light Meter only).
- **LiDAR & 3D** (camera, with your permission): measurements, room scans, point clouds and 3D models of objects. Scans are kept on the device until you share or delete them. Object capture takes photos only to build the 3D model on the device, then deletes them.
- **Lap Timer:** uses the Location sensor's positions and the motion sensors to time laps. Lap sessions are kept on the device. They leave it only in a CSV or GPX file you export.
- **Sun & Moon:** uses your location, or a place you choose, on the device to work out sun and moon times. If you search for a city, the name you type is sent to Apple's geocoder to find it. Nothing is logged.
- **GNSS Sky (predicted satellites):** see *Public data* below. The sky plot uses your location on the device and never sends it anywhere.
- **Bluetooth Sensors** (Bluetooth, with your permission):
- **Sensors:** readings from heart-rate straps, bike and foot sensors and OBD-II car adapters you connect are recorded with your trips.
- **Plant sensors:** readings from Bluetooth plant sensors are logged and kept 30 days.
- **Nearby scanner:** lists nearby Bluetooth devices while its screen is open. That list is never logged or kept.
- **Bluetooth survey** (off by default): logs, each minute, how many Bluetooth devices and how many of each kind were around, and where during a trip. It keeps counts only, never names or identifiers.
- **Machine Watch and Sensor Health Check** use the motion sensors on the device. Machines you set up stay on the device. The health check saves nothing.
## Apple Watch
The Therbie app for Apple Watch works with Therbie on your iPhone. Data moves between them over Apple's own watch connection.
- **Logger:** records vibration, sound level (levels only, never audio) and air pressure every second, and your location once every 5 minutes (with your permission). The recording is sent to your iPhone, where it's kept as a vibration session.
- **Heart rate for a trip** (with your permission, through HealthKit): while you've turned it on, the watch reads your heart rate and sends it to the trip recording on your iPhone. To do this, and to keep the Logger running with the screen off, the watch runs a workout session. That session is discarded: nothing is saved to the Health app.
- **Distance to iPhone** (Nearby Interaction, with your permission): measured only when you ask for it on the watch.
- **Trip controls:** Lap, Mark and Stop are sent to your iPhone.
## Your paired Mac
These features are off until you turn them on, and they work only over your own local network, encrypted:
- **Allow my Mac to run tests** (iPhone, iPad): sends data to Therbie on a Mac you've paired the device with. It sends:
- the device's model and iOS version, live readings and test results;
- History, including sensor logs, plus benchmark results and data usage;
- trips with their routes, vibration sessions and the sound log;
- Bluetooth plant-sensor readings, Bluetooth survey counts and datapoint counts.
The Mac keeps what it receives until you delete it, or for the time you set in its Settings (by default, forever). Changes you make on the Mac, such as renaming or deleting a trip, are sent back to the device.
- **Share this Mac's status** (Mac): sends the Mac's name, chip, model identifier, macOS version and live readings to Therbie on iPhones and iPads paired with it.
- **Export data and Share buttons:** create files that you send wherever you choose. What happens to them after that depends on where you send them.
See [Privacy and security](https://irrhuh.app/therbie/kb/privacy-security.html) for what someone else on the same network could see while these are on.
## Public data
Therbie downloads public data in two places. In each, the request contains no personal data: not your location and no identifier. As with any website, the server sees your device's IP address. Nothing is downloaded until you tap or click.
- **GNSS Sky** (iPhone, iPad): when you tap **Download orbit data**, Therbie downloads the published orbits of the GPS, Galileo, GLONASS and BeiDou satellites from CelesTrak (celestrak.org), a free public source of satellite data. It does this at most once every 12 hours, over HTTPS, without cookies. The orbits are stored on your device only.
- **Compare with Public Data** (Mac, Open Data page): when you click it, Therbie for Mac downloads Changi airport's weather reports from aviationweather.gov and Singapore's air temperature readings from data.gov.sg. It compares them with your devices' readings on the Mac. The nearest weather station is chosen on the Mac and isn't sent anywhere. The Open Data preview folder that Therbie builds stays on your Mac; nothing is uploaded.
## Notifications, widgets and Shortcuts
Alerts are local notifications created on your device. Widgets, Live Activities and Shortcuts actions read the same on-device data as the app. None of them send data to us.
## Purchases
Any purchase of Therbie is handled by Apple through the App Store. We don't receive your payment details, Apple Account or name. Apple's own privacy policy applies to that.
## Information Apple shares with developers
If you choose to share analytics with app developers in your device's settings, Apple gives us crash reports and app usage statistics that don't identify you. You can turn this off at any time in **Settings › Privacy & Security › Analytics & Improvements**.
## Children
Therbie collects no personal data from anyone, including children. The app isn't aimed at children.
## Deleting your data
- **On a device:** because we never receive your data, there's nothing for us to delete. To delete Therbie's data from a device, delete the app from it.
- **On a Mac:** to delete a device's data from the Mac, use **Delete Device…** in Therbie for Mac's **Runs & Compare**, or delete Therbie for Mac.
## This website
This help website uses no cookies, analytics, tracking scripts or third-party fonts. Pages and images are served from our own host. The host may keep standard server logs (such as IP address, time and page requested) for security and reliability. We don't use them to identify or track visitors.
## Contact
Questions about privacy: see [Help and contact](https://irrhuh.app/therbie/support.html).
## Changes
If this policy changes, we'll update the date at the top of this page. If Therbie ever starts collecting personal data, we'll say so here before it does, and in the app.
- **16 November 2026:** added the Apple Watch app, Bluetooth Sensors, Light Flicker, LiDAR & 3D, Identify sounds, the Mac's Open Data page and public-data comparison, and changes the Mac can send to a device. Corrected that trips are sent to a paired Mac, and that the sound log is on by default. Added how long data is kept and how to delete it.
- **8 November 2026:** the previous version.
---
id: support
type: faq
title: Help and contact
summary: To get help with Therbie, check the Troubleshooting page first, then email therbie@irrhuh.app. Include your device model, its iOS, iPadOS or macOS version, and your Therbie version. Never send passwords or Apple Account details.
section: legal
url: "https://irrhuh.app/therbie/support.html"
related: [troubleshooting, faq, privacy, privacy-security]
platform: [iphone, ipad, mac, watch]
applies_to: 1.0
updated: 2026-11-16
---
# Help and contact
## How do I get help with Therbie?
Check [Troubleshooting](https://irrhuh.app/therbie/kb/troubleshooting.html) and the [frequently asked questions](https://irrhuh.app/therbie/kb/faq.html) first: most questions are answered there. If yours isn't, email [therbie@irrhuh.app](mailto:therbie@irrhuh.app).
## What should I put in my email?
These three details let us answer without asking again:
| Detail | Where to find it on iPhone or iPad | Where to find it on a Mac |
|---|---|---|
| **Device model** | **Settings › General › About › Model Name** | **Apple menu › About This Mac** |
| **System version** (iOS, iPadOS or macOS) | **Settings › General › About › iOS Version** (or **iPadOS Version**) | **Apple menu › About This Mac** |
| **Therbie version** | **Settings › General › iPhone Storage › Therbie** (or **iPad Storage**). The version is under the app's name | **Therbie › About Therbie** |
Also helpful:
- **What happened, and what you expected.** Include any message Therbie showed, word for word.
- **Steps to make it happen again,** if you know them.
- **For a pairing or Mac problem:** whether both devices are on the same network, and what the Mac's **Devices** page shows for the device.
- **A screenshot,** if it helps. Check it doesn't show anything private first, such as your Mac's name, other apps, or a map of where you live.
## What shouldn't I send?
Never send passwords, your Apple Account details, payment details or verification codes. We'll never ask for them.
Don't send your data files, trips or sound logs unless we ask for a specific one to investigate a problem. If we do, we'll tell you what we need and why.
## Can you see my data or delete it?
No. Therbie doesn't send your readings to us, so we have nothing to look at or delete. Your data stays on your devices and on a Mac you've paired.
- **To delete Therbie's data from a device,** delete the app.
- **To delete a device's data from your Mac,** use **Delete Device…** in **Runs & Compare** in Therbie for Mac.
See the [privacy policy](https://irrhuh.app/therbie/privacy.html).
## Can Therbie add a feature I need?
You're welcome to suggest one by email. We can't promise when, or whether, a feature will be added.
## Where do I report a security problem?
Email [therbie@irrhuh.app](mailto:therbie@irrhuh.app) with "Security" in the subject. Please don't post the details publicly until we've replied.
---
id: for-ai-tools
type: reference
title: For AI tools
summary: Every page of Therbie Help is published as Markdown and as JSON so AI assistants and search engines can read it, quote it and link back to it accurately.
section: legal
url: "https://irrhuh.app/therbie/for-ai-tools.html"
related: [index, glossary, faq]
applies_to: 1.0
updated: 2026-11-16
---
# For AI tools
There's no chatbot here. Every page of Therbie Help is published so AI assistants, and the search engines behind them, can read it, quote it and link back to it accurately.
## What's published
| File | What it holds |
|---|---|
| [/therbie/llms.txt](https://irrhuh.app/therbie/llms.txt) | What Therbie is, then every page with a one-line summary, grouped by section |
| [/therbie/llms-full.txt](https://irrhuh.app/therbie/llms-full.txt) | Every page as Markdown in one file |
| [/therbie/index.json](https://irrhuh.app/therbie/index.json) | One record per page: its metadata and its full text |
| /therbie/pages/<id>.md | Each page as Markdown, with its metadata as front matter |
| schema.org JSON-LD | In every page's HTML: `HowTo` for guides and tasks, `FAQPage` for the FAQ and troubleshooting, `TechArticle` for the rest |
## Fields
| Field | Meaning |
|---|---|
| `id` | The page's permanent id, also the name of its `.md` file |
| `type` | `guide`, `task`, `screen`, `concept`, `reference`, `troubleshooting`, `faq`, `glossary` or `legal` |
| `title`, `summary` | The page's title, and one or two sentences that answer its question |
| `section` | `home`, `start`, `device` (iPhone and iPad), `mac`, `kb` or `legal` |
| `url`, `markdown` | The page's address, and its Markdown copy |
| `related` | Ids of the pages worth reading next |
| `platform` | `iphone`, `ipad`, `mac`, `watch` |
| `applies_to`, `updated` | The Therbie version the page describes, and the date of its last real change |
| `text` | The whole page as Markdown, with absolute links (index.json only) |
## Reading the pages well
- **What Therbie can show depends on the platform.** iOS doesn't let apps read component temperatures in °C. Therbie shows the thermal state iOS reports (Normal, Warm, Hot, Critical). Each page says what iOS does and doesn't allow.
- **Readings are made on the device.** Data moves only between the user's own paired devices.
- **Exact labels** from the app are in bold, and paths use ›.
- **If a page doesn't say Therbie can do something, assume it can't.** Please don't infer features.