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.0a11.tar.gz (17.7 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.0a11-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ble2mqtt-0.1.0a11.tar.gz
  • Upload date:
  • Size: 17.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.53.0 CPython/3.9.0

File hashes

Hashes for ble2mqtt-0.1.0a11.tar.gz
Algorithm Hash digest
SHA256 22f8995e71ee56bac2b207ec6fe8031fe7b4f0c878712355b47376bfa93b2c65
MD5 57cf71f1b54e8edea5a6fd48d5d18824
BLAKE2b-256 148b1c8eec81674dcbb535517ebc64b70d57781fe78dda88c14a6a86dc0cacdd

See more details on using hashes here.

File details

Details for the file ble2mqtt-0.1.0a11-py3-none-any.whl.

File metadata

  • Download URL: ble2mqtt-0.1.0a11-py3-none-any.whl
  • Upload date:
  • Size: 21.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.53.0 CPython/3.9.0

File hashes

Hashes for ble2mqtt-0.1.0a11-py3-none-any.whl
Algorithm Hash digest
SHA256 26c017efd4b36b66d5d9325206142c852a107f49a1485a3e04afaa995ef5ad07
MD5 f45274c1e810fd9b529e24c5bd9186b0
BLAKE2b-256 e3f8d25d3d47328b5c2ac9e6ee8be9d6e133d3c145a11d92bdd626a7a37db744

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