pywebasto

Python client for Webasto ThermoConnect devices.

The protocol is reverse engineered. There is no official Webasto API for this module.

Warning

USE THIS MODULE AT YOUR OWN RISK.

Installation

pip3 install pywebasto

Login

The preferred login is with an app client_id and client_secret.

import asyncio

from pywebasto import WebastoConnect


async def main() -> None:
    webasto = WebastoConnect(
        client_id="your-client-id",
        client_secret="your-client-secret",
    )

    try:
        await webasto.connect()

        for device in webasto.devices.values():
            print(f"{device.name}: {device.temperature}{device.temperature_unit}")
    finally:
        await webasto.close()


asyncio.run(main())

You can read the values after connect:

print(webasto.client_id)
print(webasto.client_secret)

Store them somewhere safe and reuse them next time.

The client is shown as Android 3.2.0 in Webasto's client list by default. If you want a custom name/version there, pass a short text with three parts. The first part is shown as the name, the second as the version, and the third must be an integer stamp:

webasto = WebastoConnect(
    client_id="your-client-id",
    client_secret="your-client-secret",
    client_info="my-client 1.0 0",
)

First Run With Email And Password

If you do not have app credentials yet, you can still start with email and password. The module will create an app client and save it if you give it a file path.

import asyncio

from pywebasto import WebastoConnect


async def main() -> None:
    webasto = WebastoConnect(
        username="your-email",
        password="your-password",
        credential_store_path="webasto_credentials.json",
    )

    try:
        await webasto.connect()

        print(webasto.client_id)
        print(webasto.client_secret)
    finally:
        await webasto.close()


asyncio.run(main())

Integrations that already have their own storage can use credential_load and credential_save instead of credential_store_path.

On first run, a device may need approval in the ThermoConnect app. If a device is waiting for approval, device.pending_approval is True. Approve it in the app and then call:

await webasto.update(force=True)

Email and password are still needed for:

• first-time association when app credentials do not already exist
• set_low_voltage_cutoff
• set_temperature_compensation
• webapi-only settings

When they are provided, connect() loads the webapi-only settings for each associated device. Settings writes reload those values from the webapi response.

Updates

Status is read from the app endpoint. Normal update() calls are cached for 60 seconds. One update reads all devices associated with the app client. It does not use webapi change_device.

await webasto.update()

Use force=True when you know you need fresh data:

await webasto.update(force=True)

Available Properties

Functions

Association

Manual association:

status = await webasto.associate_device(
    device_id="device-id-from-label",
    check_id="check-id-from-label",
)
print(status)

If you start with email/password and no app credentials, connect() creates an app client and starts association for webapi devices it can find. For accounts with more than one device, it may use webapi change_device during this bootstrap step to read each device's check_id.

The usual first status is pending. Approve the request in the ThermoConnect app, then refresh:

await webasto.update(force=True)

Timers

Timer support is for simple timers.

from pywebasto import SimpleTimer

timers = await webasto.get_timers(device)

new_timer = SimpleTimer(
    start=830,  # minutes after midnight UTC
    duration=5400,  # seconds
    repeat=31,  # Monday-Friday
    enabled=True,
)

await webasto.save_timers(device, timers + [new_timer])

save_timers() sends the full timer list. To edit or delete a timer, read the list, change it locally, and save the whole list again.

Weekday bitmask:

• Monday = 1
• Tuesday = 2
• Wednesday = 4
• Thursday = 8
• Friday = 16
• Saturday = 32
• Sunday = 64

Examples:

• repeat=31 means Monday-Friday
• repeat=17 means Monday and Friday
• repeat=0 means no repeat

Location

Use the app endpoint to enable or disable location services:

await webasto.set_location_services(device, True)

After enabling, the device can report WAITING_FOR_LOCATION until a fresh position is available.

Notes

• Commands and normal status reads use the app backend.
• Email/password login uses the older webapi only when it is needed.
• Command writes are not retried automatically.
• Rate-limited responses raise an exception.