g2labs-blester 0.1.0

BLE scanner daemon that publishes findings to an MQTT topic

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

Flag	Default	Description
--mqtt-host	(required)	MQTT broker hostname or IP
--mqtt-port	1883	MQTT broker port
--mqtt-username	—	MQTT username
--mqtt-password	—	MQTT password
--scan-duration	5.0	BLE scan window in seconds
--scan-interval	0.0	Pause between scans (0 = continuous)
--log-level	INFO	DEBUG / INFO / WARNING / ERROR

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