denng / ble_monitor

BLE monitor passively monitors BLE sensors (Xiaomi, Qingping, ATC, BlueMaestro, Brifit, Govee, Kegtron, Moat, Inkbird, iNode, Yeelight, RuuviTag, SensorPush, Teltonika, Thermoplus and Thermopro)

Passive BLE Monitor integration

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.

More info

• Documentation
• Installation instructions
• Configuration
• Supported devices
• Parse_data from ESPhome
• DIY sensors
• FAQ
• New sensor request
• Developer documentation
• Forum
• Report issues

Supported sensor brands

• Acconeer
• Air Mentor
• Amazfit
• ATC (custom firmware for Xiaomi/Qingping sensors)
• BlueMaestro
• BTHome v1
• b-parasite
• Ela
• Govee
• HHCC
• Inkbird
• iNode
• Jaalee
• Jinou
• Kegtron
• KKM
• Mikrotik
• Moat
• Oral-B
• Qingping
• Relsib
• Ruuvitag
• Sensirion
• SensorPush
• SmartDry
• Switchbot
• Teltonika
• Thermobeacon (Thermoplus, Brifit, Oria)
• Thermopro
• Tilt
• Xiaogui (Scale)
• Xiaomi (MiBeacon)
• Xiaomi (MiScale)

Important announcement about the future of BLE monitor

Home Assistant 2022.8 has (improved) support for passive BLE devices directly in Home Assistant. For each brand, a core BLE integration will be developed, such that maintanance can be divided over more people, using the latest Bluetooth packages (bleak). I'm working together with the Home Assistant devs to move sensors from BLE Monitor to Home Assistant core integrations. During the transition, BLE monitor will still be available, but it is possible that the core HA Bluetooth integrations will not work niceley parallel to BLE monitor. If it is not working together (common symptom is that core integrations stop updating after a while), try to enable active scan in the BLE Monitor. My advise, when all your sensors are available in Home Assistant, make the move. The aim is to have all sensors moved into Home Assistant as core integration. After the move, BLE monitor will probably be deprecated. If you want to help moving sensors from BLE monitor, feel free to help. Check out the links below.

Some interesting links

• Most pypi packages for the BLE parsing will be developed and collected here: https://github.com/Bluetooth-Devices

Available as official HA integration

The following integrations are available as official Home Assistant integration.

• BlueMaestro
• b-parasite (will be using BTHome with new firmware)
• BTHome
• Govee
• HHCC
• iBeacon
• Inkbird
• Kegtron
• Moat
• Oral-B
• Qingping
• RuuviTag
• SensorPush
• Sensirion (MyCO2 gadget)
• Thermobeacon
• Thermopro / Sensorpro
• Thermobeacon (Thermoplus, Brifit, Oria)
• Tilt
• Xiaomi (part 1 and 2)
• Device tracking based on MAC address (Bluetooth LE tracker integration)