Python API and command line tool for talking to the Nest™ Thermostat
Branch: master
Clone or download
Pull request Compare This branch is 25 commits ahead of smbaker:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
nest_thermostat
.gitignore
LICENSE.md
MANIFEST.in
README.md
nest.py
setup.py

README.md

#nest_thermostat

a Python interface for the Nest Thermostat

fork of pynest by Scott M Baker, smbaker@gmail.com, http://www.smbaker.com/

##Installation [sudo] pip install nest-thermostat

##Usage

Module

You can import the module as nest_thermostat. Use the source, luke!

Tips: you need to manually call .login() first, and .get_status() before .show_*()

Command line

syntax: nest.py [options] command [command_args]
options:
   --user <username>      ... username on nest.com
   --password <password>  ... password on nest.com
   --celsius              ... use celsius (the default is farenheit)
   --serial <number>      ... optional, specify serial number of nest to use
   --index <number>       ... optional, 0-based index of nest
                                (use --serial or --index, but not both)

commands:
    temp <temperature>         ... set target temperature
    fan [auto|on]              ... set fan state
    mode [cool|heat|range|off] ... set fan state
    away                       ... toggle away
    show                       ... show everything
    curtemp                    ... print current temperature
    curhumid                   ... print current humidity
    curmode                    ... print current mode

examples:
    nest.py --user joe@user.com --password swordfish temp 73
    nest.py --user joe@user.com --password swordfish fan auto

Chris Burris's Siri Nest Proxy was very helpful to learn the Nest's authentication and some bits of the protocol.