weirded / nest_thermostat

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

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

#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.

About

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

License:Other


Languages

Language:Python 100.0%