# custom-components/ble_monitor

BLE monitor for passive BLE sensors

Repository: https://github.com/custom-components/ble_monitor
Canonical: https://ross.abutalabs.com/products/ble_monitor
Homepage: https://community.home-assistant.io/t/passive-ble-monitor-integration/
Language: Python
License: MIT
License Family: permissive
Topics: home-assistant, hassio, custom-component, hacs, mitemp-bt, xiaomi-sensors, homeassistant, xiaomi, mijia, mibeacon, atc, qingping, kegtron, scales, thermoplus, govee, inkbird, thermopro, thermplus
Last push: 2026-08-24T19:12:31+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 2473, "days_push": 9, "days_rel": 9, "gap_med": 11.5, "n_releases_24m": 31}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2235, forks 281 (observed 2026-08-28T04:06:29.299754+00:00)

## What it is
A Home Assistant custom component that passively monitors Bluetooth Low Energy sensors from many brands (Xiaomi, Qingping, Govee, Inkbird, Ruuvitag, and more) by parsing BLE advertisement packets. It also supports BLE device tracking by MAC address or UUID and can receive forwarded data from ESPHome.

## Use cases
- read Xiaomi Mi temperature and humidity sensor data in Home Assistant
- passively monitor BLE sensors without draining their batteries
- track BLE devices by MAC address or UUID for presence detection
- collect data from Govee, Inkbird, Qingping, and Ruuvitag sensors locally
- replace the built-in mitemp_bt integration with broader device support
- parse BLE advertisements from multiple Bluetooth interfaces simultaneously
- integrate DIY BTHome sensors with Home Assistant

## When to choose
- you use many BLE sensor brands not covered by Home Assistant core integrations
- you want passive, battery-friendly BLE monitoring instead of polling
- you need device tracking for BLE devices with static MAC addresses
- you want to run multiple Bluetooth interfaces or DIY sensors

## When to avoid
- you run a recent Home Assistant version where core Bluetooth integrations already support your devices
- you rely on ESPHome Bluetooth proxies, which cannot forward data to this component
- you want a fully maintained official integration rather than a community custom component

## Facets
- artifact type: plugin
- maturity: active
- function: iot, monitoring, parser, workflow-automation
- domain: iot
- platform: python, self-hosted
- tags: home-assistant, bluetooth-low-energy, ble-sensors, xiaomi, hacs, custom-component, passive-monitoring, device-tracker, smart-home, automation, sensors, linux

## Member repositories
- custom-components/ble_monitor (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:29.299754+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-30T02:44:18.924801+00:00, confidence not recorded.
  - readme: https://github.com/custom-components/ble_monitor (fetched 2026-08-28T04:06:29.299754+00:00, sha 2f58eb0ddfef)
  - homepage: https://community.home-assistant.io/t/passive-ble-monitor-integration/ (fetched 2026-08-29T10:25:06.648887+00:00, sha e07c07fb0cf4)
  - site_page: https://community.home-assistant.io/t/install-ha-on-old-laptop-without-uefi/407443/7 (fetched 2026-08-29T10:25:06.663776+00:00, sha 543461a5c086)
  - site_page: https://community.home-assistant.io/c/projects/custom-integrations/47 (fetched 2026-08-29T10:25:06.658401+00:00, sha 50ed638a7526)
  - site_page: https://www.home-assistant.io/integrations/mitemp_bt (fetched 2026-08-29T10:25:06.660249+00:00, sha 0a7eea5a9977)
  - site_page: https://www.home-assistant.io/integrations/bluetooth_le_tracker (fetched 2026-08-29T10:25:06.662052+00:00, sha 3119b99e9113)
- Data as of 2026-08-30T08:39:29.467469+00:00.