Home Assistant homee integration

Component to integrate with homee.

Based on the intial work of FreshlyBrewedCode

Integration is in HACS Default Repositories now!

⚠️ Moving Homee integration into HA Core

I'm in the process of making this integration a part of Homeassistant Core. The first step will be made with HA 2025.02. At this point not all functionality will be transferred, so please keepo using this integration for the time being. You will see a warning in HA:

please ignore that.

When all functionality is ported to HA Core, steps for migration will be added here.

Installation

⚠️ Backup homee and Home Assistant!

HACS (recommended)

1. Make sure the HACS integration is properly installed for your instance of home assistant.
2. In the HACS UI search for "homee".
3. Click on the entry and then choose "download" in the lower right corner of the screen.
4. Continue with Configuration

Manual installation

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called homee.
4. Download all the files from the custom_components/homee/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant.
7. Continue with Configuration

Configuration

ℹ️ Because of a bug (#5) configuring more than one homee in Home Assistant can cause strange behaviour - feedback is appreciated.

1. In the HA UI go to "Configuration" -> "Integrations" and click "+", search for "homee", and select the "homee" integration from the list. Or click here:
2. In the dialog enter the ip-address of the cube and username / password of a homee account that can access your cube. Then click submit.
3. Click submit. Your devices will be automatically added to Home Assistant.

This component will set up the following platforms.

Platform	Description
alarm-control-panel	Integrate the homee status.
binary_sensor	Integrate homee devices that provide binary state information like on/off or open/close.
climate	Integrate homee devices that provide temperature and can set a target temperature. Currently only heating thermostats are supported.
cover	Integrate homee devices that provide motor and position functions such as blinds and shutter actuators
event	Integrate events from button remots from homee.
light	Integrate lights from homee.
lock	Integrate locks from homee.
number	Integrate number entities - usually settings of some kind.
sensor	Integrate homee devices that provide readings.
switch	Integrate homee devices that can be turned on/off and can optionally provide information about the current power consumption.

Homee device not working correctly?

As of now this integration has support for a few devices only. If you have Homee devices, that are not discovered or not working correctly, open an issue and do the following to provide a log:

1. In HA choose "Settings -> Devices & services -> Homee" and enable Debug logging. (Last option in then menu on the left.)

2. With the three dot menu on the right reload the integration

   

3. Disable debug logging again and the download of the log will be triggered.

4. Look for lines containing <Date/Time> INFO (MainThread) [custom_components.homee] Found node ... and copy them

5. Open an issue describing the device and paste the logs in the corresponding section

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

Home Assistant encourages developers of integrations to use a separate python package that handles the communication between Home Assistant and the different devices (i.e. python api/backend). This integration uses pyHomee to connect and communicate with the homee websocket api. For some features it may be necessary to make changes to pyHomee first.

---