https://github.com/koproductions-code/ha-groheblue
A homeassistant integration for interacting with your Grohe Blue Home or Grohe Blue Professional
https://github.com/koproductions-code/ha-groheblue
faucet grohe home-assistant water
Last synced: over 1 year ago
JSON representation
A homeassistant integration for interacting with your Grohe Blue Home or Grohe Blue Professional
- Host: GitHub
- URL: https://github.com/koproductions-code/ha-groheblue
- Owner: koproductions-code
- License: mit
- Archived: true
- Created: 2024-10-14T22:04:51.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-01-16T14:07:53.000Z (over 1 year ago)
- Last Synced: 2025-02-20T17:45:33.810Z (over 1 year ago)
- Topics: faucet, grohe, home-assistant, water
- Language: Python
- Homepage:
- Size: 43.9 KB
- Stars: 14
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HA GroheBlue
This is a HomeAssistant integration to interact with Grohe Blue Home devices. It is fairly new but functional. If you encounter any bugs, feel free to create an issue.
## :bangbang: This integration will soon be archived :bangbang:
Together with [@Flo-Schilli](https://github.com/Flo-Schilli) I developed an integration implementing all Grohe Smarthome devices, which has more features, cosmetic optimizations and is more stable.
Going forward, this integration won't recieve any updates and may break in the future. I suggest switching to the new integration to avoid any future problems.
It can be found [here](https://github.com/Flo-Schilli/ha-grohe_smarthome). If you install the new integration, make sure to remove this one from your
Home Assistant setup to avoid potential conflicts.
## Disclaimer
I am not affiliated with Grohe or the Grohe app in any way. The integration is based on the python-package called "groheblue", which is based on the undocumented Grohe-API. If Grohe decides to change the API in any way, this could break the integration. Even tough I tested this integration with my device for several weeks without any malfunction, I am not liable for any potential issues, malfunctions, or damages arising from using this integration. Use at your own risk!
## Installation
1. Open the HACS panel in your Home Assistant frontend.
2. Navigate to the "Integrations" tab.
3. Click the three dots in the top-right corner and select "Custom Repositories."
4. Add a new custom repository:
- URL: https://github.com/koproductions-code/ha-groheblue
- Category: Integration
7. Click "Save" and then click "Install" on the Grohe Blue integration.
8. Then, restart your HomeAssistant Instance and go to Settings -> Devices & Services -> Add Integration and search for "Grohe Blue".
9. Enter your Grohe credentials and click on "Submit".
## Usage
### Options:
You can set the polling interval of integration manually in the "Configure" menu of the integration. Be aware that there might be limits with the Grohe API how often one can ask for new data. In my testing, a polling interval of 300 seconds seemed to work best.
### This integration offers:
- [x] All sensor readings that are available from the api
- [x] Service action to dispense water
- [x] Custom service action to reset filter & CO2, execute auto flush etc.
## License
This project is licensed under the [MIT](https://github.com/koproductions-code/ha-groheblue/blob/master/LICENSE) license.
## Contact
If you encounter any bugs or have a request for a feature, feel free to create an issue on GitHub.