Skip to content

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

License

Notifications You must be signed in to change notification settings

ruebenramirez/nest_thermostat

 
 

Repository files navigation

#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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 96.5%
  • Shell 3.5%