Registry / devops / homeconnect-websocket

homeconnect-websocket

JSON →
library1.5.3pypypi✓ verified 80d ago

A Python async library for interacting with the Home Connect API via WebSocket, enabling real-time communication with compatible home appliances. Current version: 1.5.3 (requires Python >=3.13). Release cadence is irregular.

devops
pip install homeconnect-websocket
github ↗homepage ↗
INSTALL
IMPORT
SIG · HOMECONNECT-WEBSOC
H
homeconnect-websocket
devopspythonv1.5.3
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

HomeAppliance
✓ from homeconnect_websocket import HomeAppliance
✗ from homeconnect_websocket import HomeConnectApplianceClient
Message
✓ from homeconnect_websocket import Message
parse_device_description
✓ from homeconnect_websocket import parse_device_description

Create a client, connect, and fetch appliance status.

import asyncio from homeconnect_websocket import HomeConnectApplianceClient async def main(): client_id = 'YOUR_CLIENT_ID' client_secret = 'YOUR_CLIENT_SECRET' appliance_ha_id = 'YOUR_APPLIANCE_HA_ID' api_token = 'YOUR_API_TOKEN' async with HomeConnectApplianceClient( client_id, client_secret, appliance_ha_id, api_token ) as client: status = await client.get_status() print(status) asyncio.run(main())
Debug
Known issues
breakingThe library uses asyncio and requires a running event loop. Mixing with synchronous code without proper event loop management will cause errors.
fix
Ensure you run all interactions within an async context (e.g., asyncio.run).
affects: >=1.0.0
gotchaThe `appliance_ha_id` is the Home Appliance ID (HA ID), not the serial number. Using the wrong ID leads to authentication failures.
fix
Obtain the HA ID from the Home Connect developer portal or the OAuth token response.
affects: >=1.0.0
Upgrade
Version history
1.5.3latest on PyPI · released Mar 21, 2026
Audit
Dependencies
aiohttprequiredHTTP client for REST calls.
websocketsrequiredWebSocket client library.
Agent activity
10 hits · last 30 days
node
10
Resources
githubhttps://github.com/chris-mc1/homeconnect_websocket ↗
homepagehttps://github.com/chris-mc1/homeconnect_websocket ↗
homeconnect-websocket — pip install homeconnect-websocket · libregistry