Python API wrapper for Watts Vision+ smart heating system
Project description
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 scheduleCOMFORT- Comfort modeECO- Energy saving modeOFF- Turn off heatingDEFROST- Defrost modeTIMER- 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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file visionpluspython-1.1.0.tar.gz.
File metadata
- Download URL: visionpluspython-1.1.0.tar.gz
- Upload date:
- Size: 9.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cbe68bae49f7530d7c31642f5ef4e1c6ecd6e753c2804b3f20992c4d090d78cb
|
|
| MD5 |
a457aa0acf29fdf01f80d24be3c608ae
|
|
| BLAKE2b-256 |
436f1348c2c7472f8e155c5b925044d66674927b7bccb58e6f1762c01647f9a6
|
File details
Details for the file visionpluspython-1.1.0-py3-none-any.whl.
File metadata
- Download URL: visionpluspython-1.1.0-py3-none-any.whl
- Upload date:
- Size: 10.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
829a4b9dd42dc0427f7322e83712eb2f39536fd8d855509a12fbfb537518923f
|
|
| MD5 |
9bf54b8861e2110afa1317db700779a4
|
|
| BLAKE2b-256 |
0afcd7aceb7524075a74218d6feb281f928df3ad1188f9f67a23e5a60e171a27
|