BTHome Monitor icon

BTHome Monitor Support

Monitor & proxy BTHome data on iOS

Features

  • Discovers and displays nearby BTHome BLE sensors in real time.
  • Supports BTHome V1 / BTHome V2 standards.
  • Home Screen widgets - small and medium widgets showing up to four measurements from a single device.
  • Lock Screen widgets - circular gauges for percentages, a centre value you choose, and automatic min/max markers on numeric readings.
  • History charts - numeric sensor values plotted over time, kept on your device.
  • Activity - a timeline of changes to binary sensors.
  • Per-device control - show or hide individual measurements, choose how much detail to keep, and set how long history is retained.
  • Webhooks - forward readings to your own endpoint, or to A Better Route Planner (ABRP) as live vehicle telemetry, choosing exactly which measurements each webhook sends.
  • Runs efficiently in the background so you never miss an update.

Get Help

Questions, issues, or feedback? Email us at accounts (dot) tangerinium (dot) nz

FAQ

Why don’t I see any devices?
Ensure Bluetooth is enabled and the nearby sensors use the BTHome protocol.

How do I add and customise a widget?
Add it the usual way, then press and hold it to choose which device it tracks and which measurements it shows. Home Screen widgets show up to four measurements; Lock Screen gauges let you pick which value sits in the centre.

Why doesn’t my widget update straight away?
iOS rate limits widget refreshes heavily, so widgets deliberately use a low level of detail to cut the number of refresh cycles needed. Each widget shows how long ago it last updated-open the app for the live reading.

Can I hide measurements I don’t care about?
Yes. Open that device’s settings and switch off anything you don’t want under Measurements.

What does the Detail setting do?
It sets how precisely each device’s readings are recorded: Low, Balanced or Maximum. A lower setting rounds readings so small fluctuations don’t register as a change, which avoids unnecessary webhook calls and history writes. Maximum passes the raw value through every time.

How do I keep a history of readings?
Turn on Retain History in a device’s settings and choose how long to keep readings-it’s off by default. Numeric measurements are then charted under History. Clear All Data under Settings › Data Management removes everything.

How do I keep scanning when I’m not in the app?
Turn on Background Listening under Settings › Listening & Power.

Can I relay data to another service?
Go to Settings › Webhooks and tap + to add a Generic webhook. Sensors to include can be specified for each webhook.

How do I send data to A Better Route Planner?

  1. Create a Telemetry API key at abetterrouteplanner.com/home/app/api-keys/telemetry.
  2. In ABRP, go to Vehicle › Edit connections (under Live Data) and choose Generic under the In-car live data heading to get your API Token.
  3. In BTHome Monitor, go to Settings › Webhooks, tap +, choose ABRP and enter the API Token and API Key.
  4. Tap Test to confirm it works, switch Enabled on, and tick the measurements you want sent.

For a good balance of accuracy and battery use, we recommend sending updates every 10 seconds with the resolution set to Medium, and including these sensors:

  • Battery (Display SOC) — % (uint8, 0x01)
  • Odometer — count (uint32, 0x3E)
  • Power — watts (sint32, 0x5C)
  • Battery charging — (uint8, 0x16)
  • AC connected — plug (uint8, 0x24)

Terms of Use

  • The app is provided “as is” without warranties of any kind.
  • You are responsible for how you use the app and any webhooks you configure.
  • We are not liable for data loss, misuse, or damages arising from use of the app.
  • Terms may be updated; continued use means you accept the latest version.