Command-line utility to control your Evohome thermostat. Written in C++.
Features
list your zones and current operating mode
set the target temperature of any zone, permanently or temporarily
set the operating mode, permanently or temporarily
Install
Prerequisites
make 3.81 or higher
CMake 3.6 or higher
cURL
Installation
Installation of EvoTherm is easy:
$ git clone git@github.com:giannivh/EvoTherm.git
$ cd EvoTherm
$ cmake .
$ make
$ make install
If you get an error on make install
, issue sudo make install
.
Or, if you’re on a mac:
$ brew install giannivh/tap/evotherm
Usage
Use evotherm --help
to get all options.
Config
If you’re running EvoTherm for the first time, you have to create a configuration file which contains your Honeywell My Total Connect Comfort credentials. You can do this manually, or let EvoTherm do it for you by issuing:
$ evotherm --config
And follow the on-screen instructions.
List
To list your zones, issue:
$ evotherm #(or evotherm --list)
Set target temperature
To set the target temperature of zones permanently, issue:
$ evotherm --zone "My Zone" --temp 21.5
To set the target temperature of zones temporarily, issue:
$ evotherm --zone "My Zone" --temp 21.5 --until "2016-10-17 22:30:00"
Please note that the until option only accepts format "%Y-%m-%d %H:%M:%S
To cancel a target temperature override, and to return to the normal schedule, issue:
$ evotherm --zone "My Zone" --cancel
You can also set multiple zones at once. Use a comma separated list for this. Example:
$ evotherm --zone "Zone1,Zone2,Zone3" --temp 16 --until "2016-10-19 23:00:00"
Set mode
To change the mode of your thermostat permanently, issue:
$ evotherm --mode auto
To change the mode of your thermostat temporarily, issue:
$ evotherm --mode auto --until "2016-10-17 22:30:00"
Where --mode
is one of the following:
auto: follow the normal schedule
eco: follow the eco schedule
away: follow the away schedule
dayoff: follow the weekend schedule
off: all heating off
custom: follow the custom schedule
Download
More info on https://github.com/giannivh/EvoTherm