Skip to content

Repository files navigation

Hisense ConnectLife for Home Assistant

HACS integration for Hisense refrigerators and freezers registered in the ConnectLife app. It has been tested against a real ConnectLife refrigerator, but additional models may expose different property names.

Current scope

  • ConnectLife OAuth login
  • cloud polling every 30 seconds and websocket updates
  • automatic discovery of refrigerators/freezers that the upstream integration previously discarded
  • read-only sensors for every scalar property reported by the appliance
  • redacted Home Assistant diagnostics for adding model-specific mappings

The ConnectLife refrigerator API is not public. This first version is intentionally read-only: it does not guess property names or send commands to a refrigerator. Temperature controls, modes and door alarms should be implemented only after diagnostics from the exact model have been reviewed.

Install with HACS

  1. In HACS, open Integrations, select Custom repositories, add https://github.com/HjortCreations/hisense-connectlife and choose Integration.
  2. Install Hisense ConnectLife and restart Home Assistant.
  3. Go to Settings > Devices & services > Add integration, search for Hisense ConnectLife, and complete ConnectLife login.

The OAuth callback currently used by ConnectLife is http://homeassistant.local:8123/auth/external/callback. That hostname must be reachable from the browser used during setup.

Manual install

Copy custom_components/hisense_connectlife to Home Assistant's config/custom_components/hisense_connectlife directory and restart Home Assistant.

Model mapping workflow

After setup, open the integration's three-dot menu and download diagnostics. The export removes tokens and appliance/account identifiers while retaining type code, feature code, and raw status properties. Those fields are required to turn raw sensors into stable temperature, door, alarm, mode, and control entities for a specific model.

Credits and license

The ConnectLife authentication, API and websocket client are based on Connectlife-LLC/HomeAssistantPlugin. The project is distributed under the MIT license; see LICENSE.

About

Home Assistant integration for Hisense refrigerators and freezers via ConnectLife

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages