https://github.com/bhuebschen/liebherr

Liebherr integration for Home Assistant
https://github.com/bhuebschen/liebherr

freezer hacs hacs-integration home-assistant homeassistant liebherr refrigerator

Last synced: about 2 months ago
JSON representation

Liebherr integration for Home Assistant

• Host: GitHub
• URL: https://github.com/bhuebschen/liebherr
• Owner: bhuebschen
• License: mit
• Created: 2025-01-26T21:36:39.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2025-03-11T22:21:11.000Z (3 months ago)
• Last Synced: 2025-04-12T04:13:37.880Z (about 2 months ago)
• Topics: freezer, hacs, hacs-integration, home-assistant, homeassistant, liebherr, refrigerator
• Language: Python
• Homepage:
• Size: 57.6 KB
• Stars: 25
• Watchers: 6
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Liebherr Integration for Home Assistant

[![GitHub Release](https://img.shields.io/github/v/release/bhuebschen/liebherr?style=flat-square)](https://github.com/bhuebschen/liebherr/releases)

[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg?style=flat-square)](https://hacs.xyz/)

![GitHub Latest Pre-Release)](https://img.shields.io/github/v/release/bhuebschen/liebherr?style=flat-square&include_prereleases&label=pre-release)  

This is a custom integration for Home Assistant that allows you to connect and control Liebherr smart devices via the Liebherr HomeAPI.

## Features

- Monitor current and target temperatures of your Liebherr fridges and freezers.

- Control device features such as switching power modes.

- View detailed information about your appliances.

## Installation

### HACS (Recommended)

1. Ensure that [HACS](https://hacs.xyz/) is installed in your Home Assistant instance.

2. Add this repository as a custom repository in HACS:

   - Open HACS in Home Assistant.

   - Go to **Integrations**.

   - Click on the three dots in the top-right corner and select **Custom repositories**.

   - Add the following URL: `https://github.com/bhuebschen/liebherr`.

   - Select **Integration** as the category.

3. Search for "Liebherr" in the HACS integrations list and install it.

[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=bhuebschen&repository=liebherr&category=integration)

### Manual Installation

1. Download the latest release from the [GitHub Releases page](https://github.com/bhuebschen/liebherr/releases).

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

1. In Home Assistant, navigate to **Settings** > **Devices & Services**.

2. Click **Add Integration**.

3. Search for "Liebherr" and select it.

4. Enter your Liebherr HomeAPI API key. (see [here](https://developer.liebherr.com/apis/smartdevice-homeapi/), how to get the key)

5. Complete the setup process.

## 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.

## Troubleshooting

- Ensure your Liebherr api key is correct.

- Check the Home Assistant logs for any errors related to the integration.

## Support

If you encounter any issues or have feature requests, please open an issue on the [GitHub Issues page](https://github.com/bhuebschen/liebherr/issues).

## 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](https://github.com/bhuebschen/liebherr/blob/main/LICENSE) file for details.