Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add new integration Homee #36526

Merged
merged 14 commits into from
Jan 27, 2025
61 changes: 61 additions & 0 deletions source/_integrations/homee.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: Homee
description: Instructions on how to setup Homee devices in Home Assistant.
ha_category:
- Cover
ha_config_flow: true
ha_release: 2025.2
ha_iot_class: Local Push
ha_codeowners:
- '@Taraman17'
ha_domain: homee
ha_platforms:
- cover
- sensor
ha_integration_type: hub
---

[Homee](https://hom.ee) is a smart home system, able to integrate various protocols such as Z-Wave, Zigbee, EnOcean, and more. The Homee {% term integration %} will let you use the {% term devices %} from your Homee in Home Assistant.

There is currently support for the following device types in Home Assistant:

- cover
- sensor


## Prerequisites

You need to create a new user in your Homee app. Create a user that is only used by Home Assistant. For security reasons, it's recommended to:

- Use a strong, unique password.
- Restrict the user's permissions for what you want to do from Home Assistant.
- Do not use this account for any other purpose.

1. In your Homee app, in the top-left corner, tap the menu button.
2. On the top right of the opening menu, tap the gear {% icon "mdi:gear-outline" %} icon.
3. Choose **Manage users**.
4. Choose **Add user** and configure the desired values.

{% include integrations/config_flow.md %}

{% configuration_basic %}
Host:
description: The IP Address of your Homee.
User:
description: The username you chose in the Prerequisites.
Password:
description: The password for that user.
{% endconfiguration_basic %}

Available devices will automatically show up in your Home Assistant installation.
New devices added to Homee will be automatically discovered after a restart of Home Assistant. This restart is only required when adding new devices, not for state updates of existing devices.

## Limitations

Changed values are reported from Homee in defined time intervals and not always in realtime. For example, while a cover moves, the position is updated only every few seconds and intermediate states may be missed by Home Assistant.

## Removing the integration

This integration follows standard integration removal, and once the integration is removed, you can also remove the dedicated user from your Homee.

{% include integrations/remove_device_service.md %}
Loading