---
id: homeconnect-websocket
version: "1.5.3"
license: unclear
license_treatment: unclear
maintenance: active
---

# homeconnect-websocket — Home Connect Websocket API

License: unclear · Maintenance: active · Downloads: 76.2K/mo

## What it is and what it does

homeconnect-websocket is a Python library for controlling HomeConnect-enabled appliances (like ovens, dishwashers, or refrigerators) over a local WebSocket connection rather than through the cloud. It handles the encryption and decryption of commands and responses using either TLS PSK or AES encryption, depending on the appliance model. The library requires you to first download encryption keys and device descriptions from the Home Connect cloud using a separate tool, then parse those descriptions into a format the library can use.

The package is built on aiohttp for async WebSocket communication, xmltodict for parsing device descriptions, and pycryptodome for cryptographic operations. It exposes a simple async API: create a HomeAppliance object with your device description and credentials, call connect(), then read and write appliance settings by name. It is actively maintained but has seen limited adoption (4 repository stars), so production use should be approached cautiously.

Use it for:

- Build a local home automation system that controls HomeConnect appliances without relying on cloud connectivity.
- Parse and cache HomeConnect device descriptions and feature mappings for offline appliance control.
- Set appliance states (power, temperature, cycle modes) programmatically via async Python code.
- Monitor and control multiple HomeConnect appliances from a single application using their local IP addresses.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Control HomeConnect appliances over a local WebSocket connection using encryption keys and device descriptions obtained from the Home Connect cloud.

Yes, if you own HomeConnect appliances and want local control without cloud dependency. The low install friction and active maintenance are positive signals. However, the unclear license status requires verification before production use, and the limited adoption (4 stars, 146 days since release) means you should test thoroughly in your environment and be prepared for potential edge cases or missing features for your specific appliance models.

## Install

pip install homeconnect-websocket
uv add homeconnect-websocket
poetry add homeconnect-websocket

## Installing homeconnect-websocket

Before you install: Low install friction with three straightforward runtime dependencies. Active maintenance with recent commits; however, the repository has only 4 stars, suggesting limited real-world adoption and testing.

License in practice: License status is unclear—no SPDX identifier or raw license text is available. Verify the actual license before using in production or distributing.

Quickstart:

# Install
pip install homeconnect-websocket

# Parse device description
from homeconnect_websocket import parse_device_description
description = parse_device_description(device_xml, feature_xml)

# Connect and control
from homeconnect_websocket import HomeAppliance
import asyncio

async def control():
    appliance = HomeAppliance(description, "192.168.1.2", "App", "app_id", psk64="key")
    await appliance.connect()
    await appliance.settings["BSH.Common.Setting.PowerState"].set_value("On")

Requires Python 3.13 or later. You must obtain encryption keys and device descriptions from a HomeConnect appliance via the Home Connect Profile Downloader tool before connecting.

Verify before relying:

- Real-world stability and error handling in production environments given the low star count and limited adoption signal.
- Whether the package handles connection failures, reconnection, or state synchronization robustly.
- Support for all HomeConnect appliance models and encryption schemes (PSK vs. AES).

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 76.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

homeconnect appliance control, local websocket appliance api, home automation homeconnect, appliance encryption psk aes, homeconnect device integration, local home connect protocol, websocket appliance communication, home-automation, iot-control, local-first

[View on SkillFed](https://skillfed.io/packages/homeconnect-websocket) · [View on PyPI](https://pypi.org/project/homeconnect-websocket/)