All Projects → FiloSottile → nest_thermostat

FiloSottile / nest_thermostat

Licence: other
Python API and command line tool for talking to the Nest™ Thermostat

#nest_thermostat

a Python interface for the Nest Thermostat

fork of pynest by Scott M Baker, [email protected], 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 [email protected] --password swordfish temp 73
    nest.py --user [email protected] --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.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].