Passive BLE monitor for Home Assistant (Marketplace integration)

Installs: 7.7k sharing analytics
GitHub stars: 2.3k
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 14.4.0, October 23, 2026
Category: Hubs and protocols, Wireless protocols
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: ble_monitor
Source: github.com/custom-components/ble_monitor
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Passive BLE monitor is a Marketplace integration that listens to passive Bluetooth LE sensors. It works locally and adds sensors, binary sensors and presence tracking to Home Assistant. Devices with a static MAC address or a beacon UUID can be tracked as present or away, with settings for scan interval and consider-home interval. Supported brands include Govee, Inkbird, Ruuvitag, SensorPush, Switchbot and several Xiaomi lines. Options cover averaging period, median instead of mean, update policy, encryption keys, and an optional active scan in place of passive scan. It is set up in the UI, and actions are provided to clean up dangling devices and to send raw HCI packet data.

Automatic summary of the README and code of custom-components/ble_monitor. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Sensors
Presence

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Passive BLE Monitor

MAC address of the Bluetooth interface/adapter
Devices
Discover devices and sensors automatically
Period to use for averaging
Log spikes
Use median instead of mean
Measurement update policy
Use active scan instead of passive scan (affects battery)
Restore state after a restart
Report unknown BLE advertisements to the HA log
Automatically restart Bluetooth adapter on failure
Raw HCI inactivity timeout (seconds, 0 = off)

Add device

MAC address
Beacon UUID
Encryption key
Temperature unit [as send by device]
Use median instead of mean
Measurement update policy
Restore state after a restart
Reset timer (in seconds, 0 = off)
Report unknown BLE advertisements to the HA log
Track device
Device tracker scan interval (in seconds)
Device tracker consider home interval (in seconds)
Delete device

After setup

MAC address of the Bluetooth interface/adapter
Devices
Discover devices and sensors automatically
Period to use for averaging
Log spikes
Use median instead of mean
Measurement update policy
Use active scan in stead of passive scan (affects battery)
Report unknown BLE advertisements to the HA log
Automatically restart Bluetooth adapter on failure
Raw HCI inactivity timeout (seconds, 0 = off)
Restore state after a restart
YAML is used, change options in YAML
MAC address
Beacon UUID
Encryption key (set to '-' to remove)
Temperature unit [as send by device]
Use median instead of mean
Measurement update policy
Restore state after a restart
Reset timer (in seconds, 0 = off)
Report unknown BLE advertisements to the HA log
Track device
Device tracker scan interval (in seconds)
Device tracker consider home interval (in seconds)
Delete device

Texts from the code of custom-components/ble_monitor.

Actions

Cleanup entriesClean up of dangling devices of the BLE Monitor integration.
Parse dataSend RAW HCI packet data to the BLE Monitor integration.Fields: Packet, Gateway ID

From the README

This custom component for Home Assistant passively monitors many different BLE devices of several different brands. BLE Monitor can also be used as device tracker for BLE devices with a static MAC address or with the UUID.

From the README of custom-components/ble_monitor, MIT License. Shortened.