Unofficial Nest API on Node

This is a very unofficial demonstration of the API used by Nest Thermostats.

For more information about the unofficial API and communication check here.

The file, app.js included demonstrates one way to use the API.

To use it as is:

Install Node from http://nodejs.org
Install the unofficial Nest Thermostat API:

npm install unofficial-nest-api
Run:

node app.js 'NESTUSERNAME' 'NESTPASSWORD'

To set the temperature, you'll need to login, and fetch the status once before calling the setTemperature function:

nest.login(username, password, function (err, data) {
    if (err) {
        console.log(err.message);
        process.exit(1);
        return;
    }
    nest.fetchStatus(function (data) {
        for (var deviceId in data.device) {
            if (data.device.hasOwnProperty(deviceId)) {
                var device = data.shared[deviceId];
                // here's the device and ID
                nest.setTemperature(deviceId, nest.ftoc(70));
            }
        }
    });
});

The example above sets the temperature of every thermostat in current structure to 70F.

Also, note that the subscribe function may not return results frequently. It's based on the data coming from your thermostats, which may not change frequently. There's a default 60 second timeout. The callback is always called, which then gives your code an opportunity to call subscribe again.

There are a handful of provided functions:

setTemperature(thermostatID, temperature)
setTemperature(temperature) => defaults to first device (only use this if you have one thermostat)
setAway(structureID [optional, default = first structure], away [optional, default=true])
setHome(structureID [optional, default = first structure])
setFanModeAuto(deviceID [optional, default = first device])
setFanModeOn(deviceID [optional, default = first device])
setTargetTemperatureType(deviceID [optional, default = first device], temperatureType ['cool','heat','range'])
ctof => Celsius to Fahrenheit
ftoc => Fahrenheit to Celsius
getStructureId => returns the first structure Id found
getStructureIds => returns all structure Ids, as an array
getDeviceIds => returns all device Ids, as an array

NolanT/unofficial_nodejs_nest

Unofficial Nest API on Node