Skip to content

README.md

Latest commit

 

History

History
127 lines (83 loc) · 6.38 KB

README.md

File metadata and controls

127 lines (83 loc) · 6.38 KB

Liebherr Integration for Home Assistant

hacs_badge GitHub Release Dynamic JSON Badge

This is an unofficial custom integration for Home Assistant that allows you to connect and control Liebherr smart devices via the Liebherr SmartHomeAPI using the simple pyliebherr library.

Important

There is now a Liebherr core integration in Home Assistant as of 2026.3 authored by @mettolon. I'll continue to respond to bug requests but won't likely make any additional improvements if and when Liebherr expands the functionality of the SmartHomeApi.

Features

  • Uses Server-Sent Events to receive updates, so now cloud-push
  • Monitor current and target temperatures of your Liebherr refridgerators and freezers.
  • Control device features such as BioFreshPlus, Hydrobreeze, AutoDoor, Presentation Lights, and Ice Makers.

Installation

HACS (Recommended)

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

or search for the Liebherr integration in HACS

Manual Installation

  1. Download the latest release from the GitHub Releases page.
  2. Extract the downloaded archive.
  3. Copy the custom_components/liebherr folder to your Home Assistant custom_components directory.
    • Example: /config/custom_components/liebherr
  4. Restart Home Assistant.

Configuration

Open your Home Assistant instance and start setting up a new integration.

Or

  1. In Home Assistant, navigate to Settings > Devices & Services.
  2. Click Add Integration.
  3. Search for "Liebherr" and select it.

Then

  1. Enter your Liebherr HomeAPI API key. (see Smart Device Home API to get a key)
  2. Complete the setup process.
  3. (Optional): Configure the polling interval and the entity type for Presentation Light (see below).

Usage

Once the integration is configured, your Liebherr devices will appear as entities in Home Assistant. You can:

  • Monitor temperatures and other metrics.
  • Control switches and settings via the Home Assistant UI or automations.
  • Change the poll interval on the configuration

Controls will map to the following domains:

Liebherr Control Homeassistant Domain
Auto Door Cover
Ice Maker, BioFreshPlus Select
Presentation Light Light or Number*
SuperCool, SuperFreeze, PartyMode, NightMode Switch
HydroBreeze Fan
Temperature Climate
image_url (Device) Image
Bottle Timer Not available

* In version ≥ 2025.12.5 the domain/type of control/entity created can be selected in the integration options.

Discover New Appliances

Currently appliances added to your Liebherr account will not be automatically discovered. Once an appliance is connected to your Liebherr account (and accessible in the SmartHome app) manually reload the integration from the integration screen:

Open your Home Assistant instance and show an integration.

and click on "Reload" on the configuration menu:

Menu Image

Update Interval (Versions prior to < 2025.5.0)

Given rate limits imposed by Liebherr in the beta SmartDevice Home API the integration can only make a request to the device control API more often than every 30s.

In these versions the devices will update independently and the goal is to make sure that on average the API is not polled more often than 5 seconds (which is the minimum based on testing). These versions calculate the poll interval for each devices' controls like this:

  • device control poll interval = 30 seconds, if number of devices ≤ 6
  • device control poll interval = 5 seconds * number of devices, if number of devices > 6.

Tip

The polling interval can be adjusted manually (within some preset limits) by changing the integration options.

Troubleshooting

  • Ensure your Liebherr api key is correct.
  • Check the Home Assistant logs for any errors related to the integration.
  • Enable debug on the integration.
  • Download and inspect the integration diagnotics.
  • If there are many HTTP 429 - Too many requests in the logs try increasing the polling interval.

Warning

This was tested on a Liebherr Device lacking:

AutoDoor (reported to be working)
Presentation Light (reported to be working both as number and light entity)
BioFreshPlus (reported to be working)
HydroBreeze (reported to be working)

If you encounter an issue with these features please submit an issue.

Acknowledgements

This is a complete rewrite of the custom intergration orginally maintained by @bhuebschen from a fork created by @skatsavos. The original intergration stopped working in Oct 2025 and the orginal maintainer did not appear to be maintaining the project.

Support

If you encounter any issues or have feature requests, please open an issue on the GitHub Issues page.

Contributions

Contributions are welcome! Feel free to submit pull requests to improve this integration.

License

This project is licensed under the MIT License. See the LICENSE file for details.