Theengs open-source tools to decode BLE sensors work on ESP32, Raspberry Pi, Android phone, etc…

Theengs is a manufacturer agnostic open-source set of tools to decode BLE sensors and integrate those into smart home and IoT solutions such as Home Assistant with notably support for autodiscovery to automatically create the sensor.

Theengs can be installed on various hardware from ESP32 to an Android phone or a Raspberry Pi SBC, and the solution currently supports close to forty BLE sensors from various companies including Xiaomi, Honeywell, and RuuviTag.



There are six components:

  • The Theengs Decoder library developed in C++ for portability and translating data from sensors into human-readable data using the JSON format.
  • The Python-based Theengs Gateway acting as a BLE to MQTT bridge for Home Assistant, OpenHAB, and NodeRED integration. It relies on the Theengs Decoder library and publishes the sensors broadcasted BLE information to an MQTT broker.
  • The OpenMQTTGateway is also BLE to MQTT bridge, but instead of targetting Linux-capable hardware like Raspberry Pi or a PC, it’s made for lower-end hardware such as ESP8266, ESP32, or Arduino (Microchip AVR) boards.
  • The Theengs Explorer, also written in Python, is designed to discover new BLE sensors and show their raw advertisement data and decoded data. The Explorer is still under development and should help users add new BLE devices to the project.
  • A Home Assistant addon
  • An Android mobile app. That’s a paid app (175 THB here, or about $4.75), but it’s also open-source and relies on the Theengs Decoder library to read broadcasted data from BLE devices and display those to your mobile device.

Theengs App

Note that you don’t necessarily need to use the mobile app, as you could run an OpenMQTTGateway on an ESP32, or the Theengs Gateway on a Raspberry Pi, or the Theengs App on an Android phone or tablet. Each acts as a local BLE to MQTT gateway with the Android app capable of displaying the sensor data without integration with a home automation gateway.

Share this:

Support CNX Software! Donate via cryptocurrencies, become a Patron on Patreon, or purchase goods on Amazon or Aliexpress

ROCK 5 ITX RK3588 mini-ITX motherboard
Notify of
The comment form collects your name, email and content to allow us keep track of the comments placed on the website. Please read and accept our website Terms and Privacy Policy to post a comment.
1 year ago

We are running out of simple and easy to remember words to name new product.

1 year ago

I could have choose Theeengs also ; -)

1 year ago

Is Theengs an alternative to Espressif ‘One-Stop-Matter’, or can they be used together? 

1 year ago

And how does the ‘Mini One Stop Shop’ fits with that?

1 year ago

Theengs and Matter have both interoperability as a common value.
For now, Theengs is compatible with BLE sensor broadcasting data, whereas Matter
leverage Thread and Wifi (Bluetooth is only used for commissioning).
So both use different communication protocols.

Khadas VIM4 SBC