/Nest-Extended

Obtaining data from and interacting with Nest Thermostats.

Primary LanguagePHPMIT LicenseMIT

Nest-Extended

Introduction

Collect, monitor, and act on extended data from Nest Learning Thermostats.

Currently, Nest-Extended relies on the unofficial Nest API (https://github.com/gboudreau/nest-api/) to gather data before creating graphs with flot (https://github.com/flot/flot).

Additionally, Nest-Extended uses a modified version of a Humidity Control script from http://mbritten.x10.mx/ to adjust humidity relative to the external temperature.

If you can think of ways to improve this project, please free to let me know or submit a pull request!

Installation

To install you'll need a webserver running PHP and MySQL. Additionally, you'll need to know how to add cron jobs.

  1. Git-Clone or Copy the files from this project into a file on your server.
  2. Create a MySQL database on your server called 'nest'. You can import the structure of this database from the 'nestdb.sql.gz' file in the resources folder.
  3. Edit the config.php in the resources folder to provide the credentials for your Nest account, your MySQL database, your Weather Underground API, set your time zone, and whether you want Nest-Extend to try and control your humidity level. You can sign up for a Weather Underground API key at http://www.wunderground.com/weather/api/?apiref=c133a2be0b541640
  4. Create a cron job for nest-get-data.php?datatype=current to run at a regular interval. I use 5 minutes. Others use 10.
  5. Create a cron job for nest-get-data.php?datatype=daily to run once per day. I usually run this at noon.
  6. You're done! Enjoy your new graphs.

Example Plot