Skip to content

KraigM/unofficial_nodejs_nest

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%