visionpluspython

A Python API wrapper for Watts Vision+ smart home system, providing easy Home Assistant integration with thermostats and switches.

Features

• OAuth2 authentication - Secure token-based authentication with automatic refresh
• Device discovery - Automatic discovery of all connected devices
• Thermostat control - Set temperature, modes, and read current status
• Switch control - Control on/off switches

Installation

From PyPI (recommended)

pip install visionpluspython

Supported Device Types

Thermostat

Control and monitor Watts heating devices.

Available thermostat modes:

• PROGRAM - Follow programmed schedule
• COMFORT - Comfort mode
• ECO - Energy saving mode
• OFF - Turn off heating
• DEFROST - Defrost mode
• TIMER - Timer mode

Switch

Control Watts switch (on/off) devices

Requirements

• Python 3.9+
• aiohttp >= 3.8.0

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

1.1.0 (2026-03-20)

• Add HVAC state to the API response
• Fix serialization issue when API does not return all device fields
• Use field default factory for available thermostat modes

1.0.2 (2025-12-17)

• Add strict typing

1.0.1 (2025-09-29)

• Use generic auth method
• Add GitHub workflows for release and publishing to PyPI

1.0.0 (2025-08-01)

• Initial release
• OAuth2 authentication support
• Device discovery and control
• Thermostat and switch support