blester

BLE scanner daemon that publishes findings to an MQTT topic.

Installation

pip install g2labs-blester

Usage

blester --mqtt-host localhost --default-topic home/ble/findings

Options

Filtering

By default, devices with no matching filter are discarded. Set --default-topic to publish unmatched devices to a catch-all topic.

Inline filters (--filter, repeatable)

blester --mqtt-host localhost \
  --filter AA:BB:CC:DD:EE:FF=home/ble/lamp \
  --filter 11:22:33:44:55:66=home/ble/sensor \
  --default-topic home/ble/unknown

Filter config file (--filter-config)

blester --mqtt-host localhost --filter-config filters.json

filters.json:

[
  {"mac": "AA:BB:CC:DD:EE:FF", "topic": "home/ble/lamp"},
  {"mac": "11:22:33:44:55:66", "topic": "home/ble/sensor"}
]

--filter and --filter-config are mutually exclusive.

MQTT payload

Each discovered device is published as a JSON object:

{
  "address": "AA:BB:CC:DD:EE:FF",
  "name": "MyDevice",
  "rssi": -72,
  "manufacturer_data": {"76": "0215..."},
  "service_uuids": ["0000180f-0000-1000-8000-00805f9b34fb"]
}

Requirements

• Python 3.9+
• Bluetooth adapter with BLE support
• Linux: bluetoothd running; may need CAP_NET_ADMIN or run as root

License

MIT © Grzegorz Grzęda