{"id":42708818,"url":"https://github.com/pyrech/homewizard_cloud_watermeter","last_synced_at":"2026-04-23T23:02:59.639Z","repository":{"id":333343705,"uuid":"1136973957","full_name":"pyrech/homewizard_cloud_watermeter","owner":"pyrech","description":"HomeWizard Cloud Watermeter Integration for Home Assistant","archived":false,"fork":false,"pushed_at":"2026-03-16T15:37:30.000Z","size":65,"stargazers_count":19,"open_issues_count":2,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-31T22:37:33.863Z","etag":null,"topics":["hacs","hacs-integration","home-assistant","homewizard","watermeter"],"latest_commit_sha":null,"homepage":"https://community.home-assistant.io/t/homewizard-cloud-watermeter-integration/977719","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/pyrech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["pyrech"],"buy_me_a_coffee":"pyrech"}},"created_at":"2026-01-18T17:34:40.000Z","updated_at":"2026-03-24T13:46:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pyrech/homewizard_cloud_watermeter","commit_stats":null,"previous_names":["pyrech/hacs_custom_repository","pyrech/homewizard_cloud_watermeter_hacs"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/pyrech/homewizard_cloud_watermeter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrech%2Fhomewizard_cloud_watermeter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrech%2Fhomewizard_cloud_watermeter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrech%2Fhomewizard_cloud_watermeter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrech%2Fhomewizard_cloud_watermeter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pyrech","download_url":"https://codeload.github.com/pyrech/homewizard_cloud_watermeter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pyrech%2Fhomewizard_cloud_watermeter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32201871,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T20:19:26.138Z","status":"ssl_error","status_checked_at":"2026-04-23T20:19:23.520Z","response_time":53,"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":["hacs","hacs-integration","home-assistant","homewizard","watermeter"],"created_at":"2026-01-29T15:02:51.759Z","updated_at":"2026-04-23T23:02:59.634Z","avatar_url":"https://github.com/pyrech.png","language":"Python","funding_links":["https://github.com/sponsors/pyrech","https://buymeacoffee.com/pyrech"],"categories":[],"sub_categories":[],"readme":"# HomeWizard Cloud Watermeter\n[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg?style=for-the-badge)](https://github.com/hacs/integration)\n![Home Assistant](https://img.shields.io/badge/home--assistant-2025.11+-blue.svg?style=for-the-badge\u0026logo=home-assistant)\n![License](https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge)\n\nA custom Home Assistant integration to track your water consumption via the **HomeWizard Cloud**, designed specifically for their [battery-powered watermeter devices](https://www.homewizard.com/watermeter/).\n\n\u003e [!IMPORTANT]\n\u003e **TL;DR: Do you need this?**\n\u003e - :zap: **Don't have a Watermeter?** This is only for the Watermeter. Other HomeWizard devices work perfectly with the official integration.\n\u003e - :battery: **Running on Battery?** Yes, you need **this** integration.\n\u003e - :electric_plug: **Running on USB?** No, stop here! Use the [official HomeWizard Energy integration](https://www.home-assistant.io/integrations/homewizard/) for real-time local data.\n---\n\n## Why this integration?\n\nThe official [HomeWizard Energy](https://www.home-assistant.io/integrations/homewizard/) integration is amazing but has a limitation: it requires the **Local API**, which is disabled when the Watermeter runs on **batteries**.\n\n**This integration bridges the gap:**\n- :white_check_mark: Fetches data from the HomeWizard Cloud.\n- :white_check_mark: Perfect for battery-powered setups (4 updates/day).\n- :white_check_mark: High-resolution historical data (5-min intervals) injected into Long Term Statistics.\n- :white_check_mark: Full Energy Dashboard support.\n\n---\n\n## Features\n\n- **Device Support:** Automatically discovers all watermeter devices linked to your account.\n- **Smart Tracking:** High-resolution consumption data (not just daily totals).\n- **Diagnostics:** Monitor Online status and Wi-Fi signal strength.\n- **Energy Dashboard:** Native integration with the Home Assistant Energy panel.\n- **Auto-Sync:** Fetches the last 48h of data to ensure no drops, even if your Wi-Fi is flaky.\n\n---\n\n## Installation\n\n### Option 1: HACS (Recommended)\n\nThe recommended way to install this integration is through the [Home Assistant Community Store (HACS)](https://hacs.xyz/).\n\n1. Open **HACS** \u003e **Integrations**.\n2. Search for `HomeWizard Cloud Watermeter` and **install** the integration.\n3. **Restart** Home Assistant.\n\n### Option 2: Manual\n\nCopy the `custom_components/homewizard_cloud_watermeter` folder into your `config/custom_components` directory, then restart Home Assistant.\n\n---\n\n## Setup\n\n1. Go to **Settings \u003e Devices \u0026 Services**.\n2. Click **Add Integration** and search for `HomeWizard Cloud Watermeter`.\n3. Log in with your HomeWizard credentials.\n5. **Energy Dashboard:** In the Water consumption section, search for \"homewizard\" entities and select the one corresponding to your device.\n\n---\n\n## Sensors provided\n\n| Sensor | Enabled by default | Description |\n| :--- | :--- | :--- |\n| **Total Usage** | true | Water usage history (L) |\n| **Last Device Sync** | true | Last time the device pushed its data to the cloud |\n| **Wi-Fi Signal** | false | Wifi signal strength (%) |\n| **Online State** | false | Whether the device was online recently or not |\n\n---\n\n## Community \u0026 Support\n\n- **Found a bug?** Please open an [Issue](https://github.com/pyrech/homewizard_cloud_watermeter/issues).\n- **Want to contribute?** Pull Requests are welcome!\n- **Official Recognition:** While this is a community project, **HomeWizard** is aware of this integration and won't block it (see [Issue #2](https://github.com/pyrech/homewizard_cloud_watermeter/issues/2)).\n\n---\n\n## :warning: Disclaimer\n\n*This is an unofficial community-driven integration. It is not affiliated with, authorized, or endorsed by HomeWizard.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyrech%2Fhomewizard_cloud_watermeter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpyrech%2Fhomewizard_cloud_watermeter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyrech%2Fhomewizard_cloud_watermeter/lists"}