Theengs Gateway is a multi-platform, multi devices Bluetooth Low Energy (BLE) to MQTT gateway that leverages the Theengs Decoder library. It retrieves data from a wide range of BLE sensors, including the LYWSD03MMC, CGD1, CGP1W, H5072, H5075, H5102, TH1, TH2, CGH1, CGDK2, CGPR1, RuuviTag, WS02, WS08, TPMS, MiScale, LYWSD02, LYWSDCGQ, and MiFlora, and translates this information into a readable JSON format and pushes those to an MQTT broker.
Enabling integration to Internet of Things (IoT) platforms or home automation controllers like NodeRED, AWS IoT, Home Assistant, OpenHAB, FHEM, ioBroker or Domoticz.
The gateway uses the Bluetooth Low Energy adapter of your Raspberry Pi, Windows, Apple desktop, laptop, or server by leveraging Python and multi-platform libraries.
You can use Theengs Gateway as a standalone solution or as a complementary solution to OpenMQTTGateway as it uses the same MQTT topic structure and the same payload messages. Your OpenMQTTGateway home automation BLE sensors integration also works with Theengs Gateway.
The gateway retrieves data from BLE sensors from Govee, Xiaomi, Inkbird, Qingping, ThermoBeacon, Blue Maestro and many more.
You can find full documentation for installation and usage here
Install Theengs Gateway as a pip package
Prerequisites:
Command:
pip install TheengsGateway
You can access advanced configuration by typing:
python3 -m TheengsGateway -h
Install Theengs Gateway as an Add ON in Home Assistant
- Add the Add-on repository into the add-on store
Or by going to Settings -> Add-ons -> Add-on store -> ⁞ (Menu) -> Repositories -> Fill in the URL https://github.com/mihsu81/addon-theengsgw -> Add.
- You should now see TheengsGateway HA Add-on at the bottom list.
- Click on TheengsGateway, then click Install.
- Under the Configuration tab, change the settings appropriately (at least MQTT parameters), see Parameters.
- Start the Add-on.
Install Theengs Gateway as a snap
Theengs Gateway is also packaged as a snap in the Snap Store. If you have snapd running on your Linux distribution, which is the case by default on Ubuntu, you can install the Theengs Gateway snap as:
snap install theengs-gateway
Have a look at the Theengs Gateway Snap documentation for more information about how to configure and start Theengs Gateway as a service.
Install Theengs Gateway as a docker
Theengs Gateway is also available from docker hub thanks to @maretodoric
docker pull theengs/gateway
1 maintainer
Metadata
1 maintainer
Release files for theengsgateway 1.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| theengsgateway-1.8.0.tar.gz | 518.2 kB | Without provenance | Details for theengsgateway-1.8.0.tar.gz |
Release files / theengsgateway-1.8.0.tar.gz
| Download URL | theengsgateway-1.8.0.tar.gz |
|---|---|
| Size | 518.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d4e562d43a8695508e92d3b7f88f786e68b22bbd841595163f057d75d49a3e97
|
|
BLAKE2b-256 checksum How to use checksums |
3b2c399faee824dbcf26c86a89cbd484c1fff68aa1ef6342802d9046ab696485
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for theengsgateway 1.8.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
