{"id":21295917,"url":"https://github.com/kamaradclimber/hydrao-dump","last_synced_at":"2025-07-11T17:30:50.848Z","repository":{"id":139931474,"uuid":"352085489","full_name":"kamaradclimber/hydrao-dump","owner":"kamaradclimber","description":"A simple script to send data from hydrao shower head to Home Assistant through an MQTT server","archived":false,"fork":false,"pushed_at":"2024-01-27T15:52:19.000Z","size":651,"stargazers_count":6,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-01-27T16:53:15.322Z","etag":null,"topics":["hacktoberfest","hydrao","iot-device","reverse-engineering"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kamaradclimber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-03-27T13:54:20.000Z","updated_at":"2024-01-21T11:18:06.000Z","dependencies_parsed_at":"2024-01-27T16:44:48.289Z","dependency_job_id":"a31138d2-21f7-4eb4-b1db-04b5dd7ac0ff","html_url":"https://github.com/kamaradclimber/hydrao-dump","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamaradclimber%2Fhydrao-dump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamaradclimber%2Fhydrao-dump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamaradclimber%2Fhydrao-dump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamaradclimber%2Fhydrao-dump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kamaradclimber","download_url":"https://codeload.github.com/kamaradclimber/hydrao-dump/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225740997,"owners_count":17516896,"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":["hacktoberfest","hydrao","iot-device","reverse-engineering"],"created_at":"2024-11-21T14:09:38.401Z","updated_at":"2024-11-21T14:09:38.892Z","avatar_url":"https://github.com/kamaradclimber.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"This repository contains a standalone script to connect an Hydrao shower head to Home Assistant via MQTT.\nIt also contains a work-in-progress wireshark dissector for the hydrao protocol.\n\n💡 Adizanni developed an [integration](https://github.com/adizanni/hydrao) for Home Assistant which should be usable.\n\n## Requirements\n\n- Home Assistant and a MQTT server\n- a bluetooth adapter\n- the mac address of the hydrao shower head\n- python \u003e= 3.7\n\n## How-to\n\n```\npip install -r requirements.txt\nexport MQTT_SERVER=1.2.3.4\nexport MQTT_PORT=1883\nexport MQTT_USER=my_user\nexport MQTT_PASSWORD=abcdef\npython ./receiver.py shower_head_mac_address\n```\n\nI'm running this script as a long running systemd service on a raspberry 2 located next to the bathroom.\n\n## Credits\n\nCode has been built my copy-pasting multiple existing scripts found to interact with bluetooth devices. If you recognize your code, drop me a note, I'll credit you.\n\n# Other files\n\nI've done a few dumps from the exchange between my first (and then my second) shower head and my phone while using the app.\nAll the .log, .pcap and .pcanpng  files are those dumps. The latter is commented with my first findings.\nOpen them with the wireshark dissector to get my current understanding of the protocol.\n\nDecoded fields:\n- volume of current shower\n- volume of the last x showers\n- color and thresholds\n- firmware and hardware versions\n- shower head device id\n\nUndecoded fields: temperature and water flow.\n\n### Some help from internet wisdom\n\nIn french: https://community.jeedom.com/t/plugin-blea-hydrao/11622/36\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamaradclimber%2Fhydrao-dump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkamaradclimber%2Fhydrao-dump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamaradclimber%2Fhydrao-dump/lists"}