miblepy fetches data from various (Xiaomi/Mijia/Mi) Bluetooth LE devices and push it to a MQTT broker. For every device supported, there are already libraries or anything else to fetch the data from - and they work perfectly. But as they are separated and often run as distinct (cron)jobs, which are not aware of each other, or even as daemons... the fight for the BLE interface starts...
miblepy solves this by acting as a "coordinator" to fetch the data in a controlled, sequential way.
Currently this is a private project tailored to my needs - but open for PRs
miblepy is available as pip package and Docker image.
pip install miblepy-
clone this repo & cd to it
git clone https://github.com/benleb/miblepy.git && cd miblepy
-
install via
-
poetry
poetry install
-
pip
pip install .
-
Copy mible.toml to ~/.mible.toml and adjust settings to your needs. ~/.mible.toml is the default location where mible expects your configuration. You can change this via --config.
Start a single round of fetching from your configured sensors in ~/.mible.toml
mible fetchtry mible --help to get more info.
To continously fetch data from your sensors check out the systemd timer and service. You can also use a classic cronjob or even an automation provided by your smart home system (home assistant for example)
The :latest tag is built from master, other tags can be found on Docker Hub
Mount your miblepy config to /miblepy/mible.toml
docker run --privileged --volume "mible.toml:/miblepy/mible.toml:ro" benleb/miblepy- VegTrug / Mi Flora plant sensors (Flower Care)
- (Xiaomi?) Mijia Bluetooth Temperature Humidity sensors with LCD (LYWSD03MMC)
- (Xiaomi?) Mi Body Composition Scale 2 (XMTZC05HM / XMTZC02HM)
- TODO
Check the already available plugins to see some examples.
- @ChristianKuehnel | plantgw miblepy's idea is based on his plantgw project
- @open-homeautomation | miflora Library to interact with FlowerCare/MiFlora devices
- @JsBergbau | MiTemperature2 Library to interact with Mi Bluetooth LCD Thermometers
- @lolouk44 | xiaomi_mi_scale Library to interact with Mi Body Composition Scale 2