{"id":14985302,"url":"https://github.com/theengs/gateway","last_synced_at":"2025-10-24T01:12:53.711Z","repository":{"id":37906461,"uuid":"445619074","full_name":"theengs/gateway","owner":"theengs","description":"Multi platform Multi devices BLE Bluetooth to MQTT gateway leveraging Theengs Decoder ","archived":false,"fork":false,"pushed_at":"2025-05-10T18:01:46.000Z","size":1601,"stargazers_count":136,"open_issues_count":31,"forks_count":34,"subscribers_count":7,"default_branch":"development","last_synced_at":"2025-05-10T19:18:50.965Z","etag":null,"topics":["ble","bluetooth","home-assistant","home-automation","homeassistant","iot","lywsd03mmc","mqtt","node-red","smarthome"],"latest_commit_sha":null,"homepage":"https://gateway.theengs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theengs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-01-07T18:38:25.000Z","updated_at":"2025-05-08T16:13:48.000Z","dependencies_parsed_at":"2024-01-23T17:45:27.465Z","dependency_job_id":"973963d9-9253-4af1-ab92-e708ab684d54","html_url":"https://github.com/theengs/gateway","commit_stats":{"total_commits":179,"total_committers":14,"mean_commits":"12.785714285714286","dds":0.5921787709497206,"last_synced_commit":"60855c6bd29f1c2fee2b296947488c4eb612dce7"},"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fgateway","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fgateway/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fgateway/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fgateway/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theengs","download_url":"https://codeload.github.com/theengs/gateway/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254518384,"owners_count":22084374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ble","bluetooth","home-assistant","home-automation","homeassistant","iot","lywsd03mmc","mqtt","node-red","smarthome"],"created_at":"2024-09-24T14:10:40.824Z","updated_at":"2025-10-24T01:12:53.633Z","avatar_url":"https://github.com/theengs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"**Theengs Gateway** is a multi-platform, multi devices Bluetooth Low Energy (BLE) to MQTT gateway that leverages the [Theengs Decoder library](https://github.com/theengs/decoder).\nIt retrieves data from a wide range of [BLE sensors](https://decoder.theengs.io/devices/devices.html), 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.\n\nEnabling integration to Internet of Things (IoT) platforms or home automation controllers like [NodeRED](https://nodered.org/), [AWS IoT](https://aws.amazon.com/iot/), [Home Assistant](https://www.home-assistant.io/), [OpenHAB](https://www.openhab.org/), [FHEM](https://fhem.de/), [ioBroker](https://www.iobroker.net/) or [Domoticz](https://domoticz.com/).\n\nThe gateway uses the Bluetooth Low Energy adapter of your Raspberry Pi, Windows, Apple desktop, laptop, or server by leveraging Python and multi-platform libraries.\n\n![Gateway](https://github.com/theengs/home/raw/development/docs/img/Theengs-gateway-raspberry-pi.jpg)\n\nYou can use **Theengs Gateway** as a standalone solution or as a complementary solution to [OpenMQTTGateway](https://docs.openmqttgateway.com/) 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.\n\nThe gateway retrieves data from BLE sensors from Govee, Xiaomi, Inkbird, Qingping, ThermoBeacon, Blue Maestro and many more.\n\nYou can find full documentation for installation and usage [here](https://theengs.github.io/gateway)\n\n## Install Theengs Gateway as a pip package\nPrerequisites:\n* Install [Python3](https://www.python.org/downloads/)\n* Install [pip](https://pip.pypa.io/en/stable/installation/)\n\nCommand:\n```shell\npip install TheengsGateway\n```\nYou can access advanced configuration by typing:\n```shell\npython3 -m TheengsGateway -h\n```\n\n## Install Theengs Gateway as an Add ON in Home Assistant\n1. Add the Add-on repository into the add-on store\n\n[![Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fmihsu81%2Faddon-theengsgw)\n\nOr by going to Settings -\u003e Add-ons -\u003e Add-on store -\u003e ⁞ (Menu) -\u003e Repositories -\u003e Fill in the URL `https://github.com/mihsu81/addon-theengsgw` -\u003e Add.\n\n2. You should now see **TheengsGateway HA Add-on** at the bottom list.\n3. Click on **TheengsGateway**, then click **Install**.\n4. Under the **Configuration** tab, change the settings appropriately (at least MQTT parameters), see [Parameters](#parameters).\n5. Start the Add-on.\n\n## Install Theengs Gateway as a snap\nTheengs Gateway is also packaged as a snap in the [Snap Store](https://snapcraft.io/theengs-gateway). 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:\n\n[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-white.svg)](https://snapcraft.io/theengs-gateway)\n\n```shell\nsnap install theengs-gateway\n```\n\nHave a look at the [Theengs Gateway Snap](https://github.com/theengs/gateway-snap) documentation for more information about how to configure and start Theengs Gateway as a service.\n\n## Install Theengs Gateway as a docker\nTheengs Gateway is also available from docker hub thanks to [@maretodoric](https://github.com/maretodoric)\n\n\u003cimg alt=\"Docker Image Size (latest by date)\" src=\"https://img.shields.io/docker/image-size/theengs/gateway\"\u003e\n\n```shell\ndocker pull theengs/gateway\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheengs%2Fgateway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheengs%2Fgateway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheengs%2Fgateway/lists"}