termoweb 0.1.1

Python client library for controlling Termo thermostats via web interface

Termoweb

Python client library for controlling Termo thermostats via web interface.

Installation

pip install termoweb

Usage

from termoweb import Termoweb

# Initialize client with your credentials
client = Termoweb(email="[e-mail]", password="your_password")

# Connect to the service
client.connect()

# Get all heaters/radiators
heaters = client.get_devices()
print(heaters)

# Set heater temperature and mode
client.set_heater(heater_id=1, mode="heat", target_temp=21.5)

Features

• Authentication: Secure login with email/password
• Device Discovery: Automatically discover connected heating devices
• Temperature Control: Get and set target temperatures
• Mode Control: Switch between heating modes
• Real-time Data: Access current room temperature and settings

API Reference

Termoweb(email, password)

Initialize the client with your Termoweb credentials.

connect()

Authenticate and establish connection to the Termoweb service.

get_devices()

Returns a dictionary of all connected heaters with their current settings:

{
    1: {
        "name": "Living Room",
        "mode": "heat",
        "target_temp": 21.0,
        "room_temp": 20.5
    }
}

set_heater(heater_id, mode, target_temp)

Set the mode and target temperature for a specific heater.

Exception Handling

The library includes custom exceptions:

• TermowebError: Base exception
• AuthenticationError: Authentication failures
• APIError: API request failures

Supported Devices

Device Type	Supported
Heaters/Radiators	✅
Thermostats	❌
Power Monitors	❌