evohome_rs

This Python package provides a fast, Rust-powered CLI for the International Honeywell Evohome heating system (MyTotalConnectComfort). It is a lightweight wrapper around the evohome_rs binary built in Rust.

Quick Start (No Installation Required)

You can run the CLI immediately without installing it using uvx:

# Login to your account
uvx evohome_rs login --email user@example.com

# Check your zone temperatures
uvx evohome_rs monitor

Installation

Install the package via pip or uv:

pip install evohome_rs
# OR
uv add evohome_rs

Once installed, you can use the evohome_rs command directly:

evohome_rs --help

CLI Usage

The project includes a binary evohome_rs for controlling your heating system from the command line.

Basic Commands

# Login (saves session to ~/.config/evohome_rs/session.json)
evohome_rs login --email user@example.com

# List locations
evohome_rs locations

# Monitor all zones
evohome_rs monitor

# Logout (clears session)
evohome_rs logout

Authentication Options

You can log in interactively, use secure credentials storage, or use environment variables to skip manual login:

1. Secure Storage (Recommended)

   evohome_rs config set-credentials --email user@example.com
   

2. Environment Variables

   • EVOHOME_USER (or EVOHOME_EMAIL): Your email address
   • EVOHOME_PASSWORD: Your password

# Example with environment variables
export EVOHOME_USER="user@example.com"
export EVOHOME_PASSWORD="secure_password"

# Now you can run commands directly without 'login'
evohome_rs locations

Temperature Control

# Set temperature for a specific zone
evohome_rs set --zone-id "Living Room" --temperature 21.0

# Boost all zones
evohome_rs boost --temp 22.0 --duration 2

# Enable Eco mode
evohome_rs eco

# Enable Vacation mode
evohome_rs vacation --temp 12.0

# Reset all zones to follow schedule
evohome_rs schedule

Detailed CLI Documentation

Please refer to the CLI Documentation.

Rust Documentation

Please refer to the main Rust README.md and API Documentation.

Disclaimer: This is an unofficial tool and is not affiliated with Honeywell or Resideo.