# agittins/bermuda

Bermuda Bluetooth/BLE Triangulation / Trilateration for HomeAssistant

Repository: https://github.com/agittins/bermuda
Canonical: https://ross.abutalabs.com/products/bermuda
Language: Python
License: MIT
License Family: permissive
Topics: ble, bluetooth-low-energy, hacs-integration, homeassistant-custom-component, triangulation, bluetooth-beacons, esphome, trilateration, bluetooth-proxy
Last push: 2026-08-25T06:33:50+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 92, longevity 80
- inputs: {"age_days": 1121, "days_push": 8, "days_rel": 53, "gap_med": 7, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1970, forks 66 (observed 2026-08-28T04:06:00.776637+00:00)

## What it is
Bermuda is a Home Assistant custom integration (installed via HACS) that tracks Bluetooth/BLE devices by room/area using ESPHome Bluetooth Proxies and Shelly devices. It computes distances from RSSI readings to create area and distance sensors and device_tracker entities, with eventual full triangulation support.

## Use cases
- track which room a bluetooth device is in with home assistant
- indoor ble presence detection using esp32 bluetooth proxies
- create device_tracker entities for phones and ibeacons in home assistant
- estimate distance to bluetooth devices from rssi
- track ios devices with rotating mac addresses via private ble device
- room-level presence automation for home assistant
- monitor bluetooth beacon positions across multiple esp32 receivers

## When to choose
- you already run Home Assistant and have ESPHome or Shelly bluetooth proxies deployed
- you want room-level (area) presence tracking for BLE devices including iBeacons and randomized MACs
- you need device_tracker entities for Home/Not Home person tracking
- you want configurable RSSI calibration and a JSON dump of receiver distances

## When to avoid
- you need precise GPS-like map coordinates - triangulation is aspirational, not fully implemented
- you don't use Home Assistant - this is a HA custom component only
- you have only a single bluetooth receiver, since area resolution needs multiple proxies
- you need high-accuracy real-time location systems (RTLS) for industrial use

## Facets
- artifact type: plugin
- maturity: active
- function: monitoring, analytics, iot
- domain: iot, self-hosted
- platform: python, self-hosted, iot
- tags: home-assistant, bluetooth-tracking, ble, esphome, trilateration, indoor-positioning, hacs, device-tracker, rssi, ibeacon, automation

## Member repositories
- agittins/bermuda (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:00.776637+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:05:07.668614+00:00, confidence not recorded.
  - readme: https://github.com/agittins/bermuda (fetched 2026-08-28T04:06:00.776637+00:00, sha d6e7f16bd118)
- Data as of 2026-08-30T08:39:29.467469+00:00.