{"id":42914629,"url":"https://github.com/hardcpp/goveeblemqttserver","last_synced_at":"2026-01-30T17:04:45.935Z","repository":{"id":69546278,"uuid":"580583039","full_name":"hardcpp/GoveeBleMqttServer","owner":"hardcpp","description":"A Govee Bluetooth Low Energy Mqtt controller","archived":false,"fork":false,"pushed_at":"2024-08-24T17:30:35.000Z","size":251,"stargazers_count":11,"open_issues_count":1,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-24T18:56:31.262Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hardcpp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"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},"funding":{"patreon":"BeatSaberPlus"}},"created_at":"2022-12-20T23:18:16.000Z","updated_at":"2024-08-24T17:30:38.000Z","dependencies_parsed_at":null,"dependency_job_id":"d49b2b01-e047-47f6-95f2-d07702ad4d23","html_url":"https://github.com/hardcpp/GoveeBleMqttServer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hardcpp/GoveeBleMqttServer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hardcpp%2FGoveeBleMqttServer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hardcpp%2FGoveeBleMqttServer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hardcpp%2FGoveeBleMqttServer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hardcpp%2FGoveeBleMqttServer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hardcpp","download_url":"https://codeload.github.com/hardcpp/GoveeBleMqttServer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hardcpp%2FGoveeBleMqttServer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28915942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T16:37:38.804Z","status":"ssl_error","status_checked_at":"2026-01-30T16:37:37.878Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-30T17:04:45.749Z","updated_at":"2026-01-30T17:04:45.920Z","avatar_url":"https://github.com/hardcpp.png","language":"Python","readme":"# GoveeBleMqttServer\nGoveeBleMqttServer is a Govee Bluetooth Low Energy Mqtt light controller.\n* Free software: MIT license\n\n![demo](demo.png)\n\n# Requirements\nA Bluetooth Low Energy compatible adapter\n\n# Installation\nRequires Python 3.\nTested under Python 3.7 on Linux, Windows\n\n```bash\npip install paho-mqtt\npip install bleak\n```\n\n# Features\n* Control Govee lights over Bluetooth Low Energy\n* Mqtt support for connecting to Home Assistant\n* Multi-zone support (To cover wider Bluetooth area)\n* Auto configuration from Home Assistant Mqtt objects\n* Keep alive BLE for fast response time\n\n# Beware: dongles with the same MAC address!\nMultiple dongles of the same brand will share the same MAC address and violates the specifications.\nHaving multiple dongles with the same MAC address will cause interference and will make the connections not working.\n\nIf you are lucky, you can re-program the dongles to change its MAC address (RUN AT YOUR OWN RISKS)\n- Windows: [Bluetooth MAC Address Changer](https://macaddresschanger.com/)\n- Linux: [bdaddr](https://github.com/thxomas/bdaddr)\n\n# Tested hardware\n- H6008 Fully functional\n- H6107 Fully functional\n- H6138 Fully functional\n- H6139 Fully functional\n- H613A Fully functional\n- H613B Fully functional\n- H6159 Fully functional\n- H6159r2 (Rev 2) Fully functional\n- H6712 Fully functional (With segment control, but not Cold/Warm)\n- H618F Fully functional (With segment control)\n\n\n# Configuration\n\nConfiguration is located at top of file main.py\n```python\nSERVER_ZONE_ID: int = 1;\nMQTT_SERVER: str = \"192.168.10.170\";\nMQTT_PORT: int = 1883;\nMQTT_USER: str = None;\nMQTT_PASS: str = None;\n```\n\n# Home Assistant\nIn configuration.yaml, for each of your light add the following:\n```yaml\nmqtt:\n    light:\n      - schema: json\n        name: \"NAME OF THE LIGHT\"\n        object_id: \"NAME OF THE LIGHT\"\n        state_topic: \"goveeblemqtt/zone1/light/MacAddressLowerNoDots_ModelNumber/state\"\n        command_topic: \"goveeblemqtt/zone1/light/MacAddressLowerNoDots_ModelNumber/command\"\n        brightness: true\n        rgb: true\n        optimistic: false\n        qos: 0\n        unique_id: \"RANDOM_UNIQUE_ID_HERE\"\n        device:\n            identifiers: \"RANDOM_UNIQUE_ID_HERE\"\n            name: \"NAME OF THE LIGHT\"\n```\nCreate a random unique id and replace RANDOM_UNIQUE_ID_HERE twice (this is used internally by Home Assistant).\n\nReplace NAME OF THE LIGHT three times by the name of your light\n\nReplace MacAddressLowerNoDots twice by the Bluetooth mac address of your light, for instance a4c13825cd56\nReplace ModelNumber twice by the model number of your light, for instance H6008\n\nMultiple lights example:\n\n![demo2](demo2.png)\n\n# Credits\n- [chvolkmann](https://github.com/chvolkmann/govee_btled/tree/master/govee_btled)\n","funding_links":["https://patreon.com/BeatSaberPlus"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhardcpp%2Fgoveeblemqttserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhardcpp%2Fgoveeblemqttserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhardcpp%2Fgoveeblemqttserver/lists"}