Skip to main content

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

Project description

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

Project details


Release history Release notifications

This version

1.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nest-thermostat, version 1.2
Filename, size File type Python version Upload date Hashes
Filename, size nest-thermostat-1.2.tar.gz (4.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page