Skip to main content

homeconnect_webthing

A webthing adapter for HomeConnect smart home devices.

This project provides a webthing API for accessing HomeConnect devices. Currently, only the dishwasher, washing machine and dryer device types are supported.

The homeconnect_webthing package provides an http webthing endpoint for each detected and supported smart home device. E.g.

# webthing has been started on host 192.168.0.23
curl http://192.168.0.23:8744/0/properties 

{
   "device_name":"Geschirrspüler",
   "device_type":"Dishwasher",
   "device_haid":"BOSCH-SMV68TX06E-70C62F17C8E4",
   "device_brand":"Bosch",
   "device_vib":"SMV68TX06E",
   "device_enumber":"SMV68TX06E/74",
   "power":"Off",
   "door":"Open",
   "operation":"Inactive",
   "remote_start_allowed":false,
   "program_selected":"Eco50",
   "program_vario_speed_plus":false,
   "program_hygiene_plus":false,
   "program_extra_try":false,
   "program_start_date":"",
   "program_progress":0
}

To install this software, you can use the PIP package manager as shown below

PIP approach

sudo pip3 install homeconnect_webthing

After this installation, you can use the Webthing http endpoint in your Python code or from the command line with

sudo homeconnect --command listen --port 8744 --refresh_token 9yJ4LXJlZyI6IfVVIiwi...2YXRlIn0= --client_secret FEAE...522BD0 

Here the webthing API is bound to the local port 8744. Also, refresh_token and client_secret must be set. Please refer to HomeConnect Authorization to obtain your refresh_token and client_secret

As an alternative to the list command, you can also use the register command to register and start the webthing service as a systemd entity. This way, the webthing service is started automatically at boot time. Starting the server manually with the listen command is no longer necessary.

sudo homeconnect --command register --port 8744 --refresh_token 9yJ4LXJlZyI6IfVVIiwi...2YXRlIn0= --client_secret FEAE...522BD0

Metadata

Release files for homeconnect-webthing 1.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for homeconnect-webthing 1.0.6
File Size Uploaded Provenance
homeconnect_webthing-1.0.6.tar.gz 23.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for homeconnect-webthing 1.0.6
File Interpreter ABI Platform
homeconnect_webthing-1.0.6-py3-none-any.whl Python 3 none any Details

Total release size: 49.4 kB

Release files / homeconnect_webthing-1.0.6.tar.gz

Download URL homeconnect_webthing-1.0.6.tar.gz
Size 23.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a2fd1930cb5ad4128bc57773e5f18e69a44fbf76d831f28a56772866746a9c1d
BLAKE2b-256 checksum
How to use checksums
93743e314bfaccd50ae40f03b7ccb4be08b6cdb93ca0e921a6eb55208da8f700
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.9.19

Release files / homeconnect_webthing-1.0.6-py3-none-any.whl

Download URL homeconnect_webthing-1.0.6-py3-none-any.whl
Size 25.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
35c1666c9a9773a33727fa86c2d2ed00c582beb6f13a6de340747ac002dad560
BLAKE2b-256 checksum
How to use checksums
e8628104f9b022dc10e131ab1b8671035de0dcb18aac3b2efc029f471799462a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.9.19

Security for homeconnect-webthing 1.0.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.6 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page