Skip to content

tslagle13/nest-manager

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Nest Manager (Unofficial)

#####IMPORTANT: There were a ton of changes to the core code so we can't guarantee that you will not have any issues when updating the code directly from v1.1. Once you update to code it is very important that you open the Nest Manager smart-app and press 'Done' to clean up old variables and switch to using the new Cron scheduler. If you have any issues after that I suggest you remove the old devices from any Apps, Routines, or Rules they are being used with, and then remove the Nest Manager smart-app and start over fresh.

Nest Manager App

This is the "unofficial" SmartThings user created SmartApp and Device handlers. The SmartApp and Device Handlers work together to provide integration to the SmartThings ecosystem using Nest's Official API.

Nest Automations App

This is an addon Child-SmartApp that allows you to creat different types of automations for your HVAC systems.

The Devices Types

Author

  • @tonesto7

Contributors

  • @desertblade
  • @E_sch

Version Info

Latest App Version:

  • Nest Manager - v2.0.8
  • Nest Automations - v1.2.2

Latest Device Versions:

  • Nest Presence Device - v2.0.2
  • Nest Protect Device - v2.0.2
  • Nest Thermostat Device - v2.0.3
  • Nest Weather Device - v1.1.1

What's New

  • NEW: In-app HTML help pages

  • NEW: All new polling logic (Also switched to Cron scheduling)

  • NEW: Support for sending commands from multiple devices by using Queuing of commands to help prevent being rate-limited by Nest. (Thanks @E_sch)

  • NEW: Custom device naming during new device installs.

  • UPDATED:Fresh device tile designs πŸ˜„ (These may cause some controversy and be asked to be reverted back) (On first load of the device it may take a few seconds to render the tiles)

  • NEW: Weather Device that will be updated with the rest of the devices so using a polling app to update the weather is no longer necessary. (Thanks @desertblade)

  • NEW: Nest Automation Child (BETA) app as a place to turn thermostats off based on contacts open/closed, outside weather temps, and remote sensor support.

  • UPDATED: Much more transparent error handling during the install process. The App will alert you in the app with a push notification and very clearly in the live logs in the IDE.
    It performs tests on the following:

    • Verify's that OAuth is enabled for the SmartApp
    • The Device Handlers are installed and published
    • That your SmartThings account contains a proper Zip-Code.
    • When uninstalling it will notify you that it can't remove the devices because they are being used by other apps/routines.
  • There are also way to many subtle changes to list.

Links

Things to Know

  • This is still technically in still in post-BETA so you may experience issues!!!

  • This app DOES NOT support Nest Cams currently mainly because I don't have any to test

  • Each install of this SmartApp will only support One location/structure and the Thermostats and Protects within

  • This version uses a new token which when we are ready to support it will allow access to Nest cams without needing to completely re-install everything.

  • The token used with this application is using my 'Works for Nest' distribution appId and secret. It's an older one which allows 1000 individual user logins before I will need to certify with Nest. I do not have the ability to see any of your data or who is even using the token

  • Devices that use html tile will not refresh with going out of the device and back in again.

  • There were a ton of changes to the core code so we can't guarantee there won't issue updating the code directly. Once you update it is important that you open the smart app and press done to clean up old variables and switch to the new Cron scheduler. If you have any issues after that I suggest you remove the old devices from any apps or routines they are under. Then remove the nest manager smartapp and start over.

Advantages

  • Able to add/remove multiples devices from a single SmartApp
  • No need to many enter device serial number and login info in preferences
  • Nest Login info is not stored by the application
  • No need to use 3rd Party Polling apps for device updates
  • One single API call for all Nest devices
  • Since there is only a single poll for all devices, updates are more often
  • The devices look great πŸ˜„

3rd-Party SmartApp Compatibility (Confirmed)

Installation

Method 1: (Recommended)

Enabling the GitHub Integration in your IDE is by far the easiest way to install and get the latest updates for Nest Connect App, Presence, Protect and Thermostat devices.

If you don't already have Git Integration setup please visit GitHub Integration Instructions

The Nest Manager and Nest Automations Apps

  • Go to "My SmartApps" in the IDE

  • Click on "Settings"

  • Click on "Add New Repository"

  • Owner: tonesto7, Name: nest-manager, Branch: master

    Nest Manager
  • Under "My SmartApps" Click on "Update from Repo" and select nest-manager (master)

  • Check the box next to nest-manager and then check "publish" then click "Execute Update"

  • Click on the Nest Manager app link and select "Publish" and "For me"

    Nest Automations
  • Under "My SmartApps" Click on "Update from Repo" and select nest-manager (master)

  • Check the box next to nest-automations and then check "publish" then click "Execute Update"

  • Click on the Nest Automations app link and select "Publish" and "For me"

    You will also need to Enable OAuth under the Nest Manager app preferences in the IDE

The Presence, Protect, Thermostat and Weather Device Handlers

  • Go to "My Device Handlers" in the IDE (Not necessary if you added repository for the app)
  • Click on "Settings"
  • Click on Add new repository
  • Owner: tonesto7, Name: nest-manager, Branch: master
  • Under My Device Types Click on Update from Repo and select the nest-manager
  • Check the box next to nest-presence, nest-protect, nest-thermostat, and nest-weather then click Execute Update
  • Click on each device link and select "Publish and For Me

That's it your Done in the IDE... Just install "Nest Manager" from the Marketplace > MyApps under the mobile app.

When updates are available to the source code you will see the color change from black in the IDE.


Method 2: The Manual Way

The Nest Manager App

  • Log into your SmartThings account at https://graph.api.smartthings.com/
  • Go to "My SmartApps"
  • Click on "+ New SmartApp"
  • Choose "From Code"
  • Copy source code from nest-manager.src
  • Click "Create"
  • Click on "Publish" and "For me"
  • Go into SmartApp Nest Manager Settings
  • Click on "App Settings" and enable OAuth and click "Update"

The Nest Automations App

  • Go to "My SmartApps"
  • Click on "+ New SmartApp"
  • Choose "From Code"
  • Copy source code from nest-automations.src
  • Click "Create"
  • Click on "Publish" and "For me"

The Presence, Protect, and Thermostat Device Handlers

  • Go to "My Device Handlers"
  • Create "New Device Handler"
  • Choose "From Code"
  • Copy Source code from nest-protect.src
  • Repeat for nest-presence.src
  • Repeat for nest-thermostat.src
  • Remember to open each device and click "Publish" and "For me"

Setting up Nest Manager App

  • In the SmartThings Mobile App
  • Go to "Marketplace" and select "SmartApps"
  • At the bottom of the list, select "My Apps"
  • Select "Nest Manager" from the list.
  • Enter you Nest Login credentials when prompted.
  • Choose Structure
  • Choose Thermostats
  • Choose Protects
  • Choose Add Presence Device (Optional)
  • Choose Add Weather Device (Optional)
  • Modify any preferences you would like (Optional)
  • Tap on "Done"

Issues and Troubleshooting

Issues

If you are experiencing any issues, please let us know by heading over to projects issues page on GitHub. If you don't see the issue reported please help open an new one and provide as much detail as you can.

Project Issues Link

In an effort to make it easier for some of you troubleshoot without having to use the IDE constantly. I have added in a diagnostic option under the preference section of the SmartApp.
Once this is enabled it will begin to store non-user identifiable error logs from the app and store in a local state variable of the app.
This feature will help you to view and export the logs (also see the tip below) directly from the Smart App. This also allows you to copy & paste them into the issues form on GitHub.

Tip: If you enable diagnostic logs in the app you can share the logs from with in the app you can store the direct link to log JSON file on you computer and browse directly to the log everytime you need to review the errors.


Troubleshooting

Tip: The most common issue is forgetting to enable oAuth for the app under SmartThings

Please check the Help Page before posting questions in the community forum. Nest Manager Help Page


Feature Requests

  • We love new ideas so please head on over to github and open an issue for the feature you would like to see. This will help prioritize what is important and what is not.
  • There is a Google Form that will allow you to vote for the newest features. Voting Form

Donations

  • While donations are very much appreciated they are not expected or required. If you feel the need to do so πŸ˜„ here is the donation link

Nest API Documentation

Nest Developer Documents

To view the json returned from the API just get your authToken from the SmartApp state data and add it to this Url

https://developer-api.nest.com/devices?auth=__yourAuthTokenHere__

About

SmartThings Nest Manager (Unofficial)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Groovy 80.1%
  • HTML 19.9%