Skip to content

JDogg016/nest-manager

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

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

Repository files navigation

Nest Manager (Unofficial)

#####IMPORTANT: Nest Automations has been merged into Nest Manager in a way that they are still 2 seperate apps but under one code base. As such it will require you to remove your existing automations before upgrading.

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 a Child-SmartApp that allows you to creat different types of automations for your HVAC systems.

The Devices Types

Author

  • @tonesto7

Contributors

  • @desertblade
  • @E_sch

Testers

  • @scpickle

Version Info

Latest App Version: | ----------- | ----------- Nest Manager | v2.5.0

Latest Device Versions: | ----------- | ----------- Nest Presence Device | v2.5.0 Nest Protect Device | v2.5.0 Nest Thermostat Device | v2.5.0 Nest Weather Device | v2.5.0

What's New

Manager App:

  • NEW: Merged Manager and Automations into one codebase but it is still two apps... Thanks @ady264"
  • NEW: Thermostat ST Mode TempSetpoint Automation to select your thermostats and each mode to use for that thermostat and then choose the heat/cool setpoints for each mode. This is completely dynamic and will allow different setpoints for each thermostat selected.
  • NEW: Remote Sensors now allows selection of switches to run along with the thermostat to help with comfort. This support includes automation detection of devices that support 3-speeds, and allows setting speed based on individual threshold temps.
  • ADDED: Ability to Disable each automations individually.
  • ADDED: You can now receive Local Weather Alerts push notifications when the Nest Weather device is installed.
  • UPDATED: There is new install setup now that flows much better and allows display of the important available options better to users.
  • UPDATED: Device data updates have been modified to be much more efficient. All necessary data is sent at once eliminating the need for the devices to call back to the manager app constantly.
  • NEW: Analytics have been added to the app to share very basic generic installation data, it will also send generic exception error data. So I can see trends among versions etc. This data is completely transparent to you and can be disabled at any time. I do not collect and identifiable data only the basics. We will also be putting up a dashboard for users who are nerdy just to see the data mapped out.
  • FIXED: Remote Sensor's Fan circulation should now work like it was intended.
  • FIXED: Nest Log Out function to actually take you back to auth screen after clearing token.
  • ADDED: You can now use Day, Time, Mode filters in most Nest Automations.
  • ADDED: View all Apps/Devices state data under diagnostics.
  • ADDED: Voice Notifications using Speech or MusicPlayer devices to Contact Automations Events work correctly with contact automation.
  • ADDED: App now supports Broadcast message from developer.
  • NEW: When updates are available there is a link in the smartapp that takes you directly to the IDE in your mobile browser.
  • UPDATED: Tapping on the Nest Manager version app top of page will now take you a Changelog page which displays those changes.
  • UPDATED: Lot's of tweaks and fixes for annoying UI bugs and to many subtle changes to list.

Weather Device:

  • Updated @desertblade remodeled the design to allow for modal popups for weather alerts, and forecast data.

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)

---------- | ---------- Keenect | @Mike_Maxwell SmartTiles | @625alex Rule Machine (Rules and Custom Commands) | @bravenel CoRE | @ady264 Keep Me Cozy (I & II) (link) | Routines | @smartthings

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
  • Make sure to Remove all existing automations before upgrading the manager.

  • Once all automations are removed please delete the Nest Automations Smart App from the IDE

    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

  • Make sure to Remove all existing automations before upgrading the manager.
  • Once all automations are removed please delete the Nest Automations Smart App from the IDE

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

    Feedback 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 78.1%
  • HTML 21.9%