Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Service to export BLE devices to MQTT with Home Assistant discovery

!!! It is a very early alpha release !!!

Use this software at your own risk.

Default config should be located in /etc/ble2mqtt.json or can be overridden with BLE2MQTT_CONFIG environment variable.

Example run command:

BLE2MQTT_CONFIG=./ble2mqtt.json python3 ble2mqtt.py

The configuration file is a JSON with the following content:

{
    "mqtt_host": "localhost",
    "mqtt_port": 1883,
    "mqtt_user": "",
    "mqtt_password": "",
    "devices": [
        {
            "address": "11:22:33:aa:bb:cc",
            "type": "redmond200"
        },
        {
            "address": "11:22:33:aa:bb:dd",
            "type": "xiaomihtv1"
        },
        {
            "address": "11:22:33:aa:bb:ee",
            "type": "xiaomilywsd"
        }
    ]
}

Supported devices:

Kettles:

  • Redmond G2xx series (redmond200)

Humidity sensors:

  • Xiaomi MJ_HT_V1 (xiaomihtv1)
  • Xiaomi LYWSD03MMC (xiaomilywsd)

OpenWRT installation

Execute the following commands in the terminal:

opkg update
opkg install python3-twisted python3-pip python3-asyncio
pip install -U ble2mqtt

Create the configuration file in /etc/ble2mqtt.json and append your devices.

Bluetooth must be turned on.

hciconfig hci0 up

Run the service in background

python -m ble2mqtt 2> /tmp/ble2mqtt.log &

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ble2mqtt-0.1.0a5.tar.gz (15.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ble2mqtt-0.1.0a5-py2-none-any.whl (19.5 kB view details)

Uploaded Python 2

File details

Details for the file ble2mqtt-0.1.0a5.tar.gz.

File metadata

  • Download URL: ble2mqtt-0.1.0a5.tar.gz
  • Upload date:
  • Size: 15.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.6

File hashes

Hashes for ble2mqtt-0.1.0a5.tar.gz
Algorithm Hash digest
SHA256 75d65436c9027b7a6845aebf9e0bdc5f4b3e54a8fa7c13e7b4b6a1a65ef4e5be
MD5 1aa0f92ca5ac1c3017a3b53653834185
BLAKE2b-256 d196047593f6cd4840d38cd7a8075263ace3d27fb1db78c331f7d43e6a640270

See more details on using hashes here.

File details

Details for the file ble2mqtt-0.1.0a5-py2-none-any.whl.

File metadata

  • Download URL: ble2mqtt-0.1.0a5-py2-none-any.whl
  • Upload date:
  • Size: 19.5 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.6

File hashes

Hashes for ble2mqtt-0.1.0a5-py2-none-any.whl
Algorithm Hash digest
SHA256 266cec08f1af687aae33d21e54c3a0b30476d302c8f50c93693805f3d32fa20e
MD5 93d72058b241206e50e4d4caf3626b31
BLAKE2b-256 2e0ebd91e35b695bce2796a9eb310d107048746e4d2a79edd661c1fa2f70a2e2

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page