venstarcolortouch

What it is and what it does

venstarcolortouch is a Python client library for Venstar ColorTouch WiFi thermostats. It wraps the thermostat's REST API to let you read current temperature, humidity, and system state, adjust heating and cooling setpoints, change operating modes (heat, cool, auto, off), control the fan, and manage away/schedule settings. The library works by making HTTP requests to the thermostat at a known IP address or hostname; you provide the address when instantiating the class, call login() to verify connectivity and API version compatibility, then use update_* methods to fetch fresh data and get_* or set_* methods to read or change settings.

The package depends only on requests and installs as a pure Python wheel with no compiled dependencies. It is actively maintained and carries no known security vulnerabilities. The main limitation is that it does not implement Venstar's device discovery protocol, so you must know the thermostat's network address beforehand.

Use it for:

• Integrate a Venstar ColorTouch thermostat into a home automation system to read indoor/outdoor temperatures and adjust setpoints programmatically.
• Build a monitoring dashboard that polls thermostat data (current temperature, humidity, runtime hours) and logs it for analysis.
• Create a script to enforce away-mode scheduling or seasonal setpoint changes across one or more thermostats.
• Trigger heating or cooling adjustments based on external conditions or time-based rules.
• Test or validate thermostat behavior by automating mode and setpoint changes and reading the results.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a Python interface to query and control Venstar ColorTouch WiFi thermostats via their REST API, allowing you to read sensor data, adjust setpoints, and manage operating modes.

Yes. The package is lightweight, actively maintained, has no security vulnerabilities, and solves a specific problem—controlling a Venstar ColorTouch thermostat—with a straightforward API. Install it if you own or manage a ColorTouch thermostat and need programmatic control; skip it if you do not have that hardware.

Install

venstarcolortouch on PyPI

pip install venstarcolortouch

uv add venstarcolortouch

poetry add venstarcolortouch

Installing venstarcolortouch

Before you install

Low install friction; depends only on requests. Actively maintained with a recent commit on 2026-08-12 and a release on 2026-07-05.

License in practice

MIT license is permissive; you can use this package freely in commercial and private projects with minimal restrictions.

Quickstart

import venstarcolortouch

ct = venstarcolortouch.VenstarColorTouch('192.168.1.252', timeout=5)
if ct.login():
    ct.update_info()
    print(ct.get_info('heattemp'))
    ct.set_setpoints(heattemp=75, cooltemp=78)

Requires network access to the thermostat at a known IP address or hostname; the API discovery protocol is not implemented.

Verify before relying

• Whether the package works with Python versions beyond 3.5, given classifiers list only up to 3.5.
• Current state of the Venstar API documentation at developer.venstar.com and whether it remains the authoritative reference.

Package facts

Evidence: venstarcolortouch-0.22-py2.py3-none-any.whl

Keywords: thermostat

Tags

More Monitoring packages