README.md

SmartThings Ring Security Cams

Overview

Control the light on Ring Floodlight and Spotlight Cams via SmartThings.

Installation Instructions:

Manually:

1. Log in to the SmartThings IDE. If you don't have a login yet, create one.
2. Create the SmartApp:
   1. Go to My SmartApps → New SmartApp → From Code.
   2. Copy contents of smartapps/farhad-a/ring-security-cams-connect.src/ring-security-cams-connect.groovy and paste into text area.
   3. Click Create.
   4. Click Publish → For Me
3. Create the custom device handler for the lights:
   1. Go to My Device Handlers → Create New Device Handler → From Code.
   2. Copy contents of devicetypes/farhad-a/ring-security-cam.src/ring-security-cam.groovy and paste into text area.
   3. Click Create.
   4. Click Publish → For Me
4. In your SmartThings mobile app:
   1. Tap Automation → SmartApps → Add a SmartApp.
   2. Scroll all the way down and tap My Apps, then Ring Security Cams (Connect).
   3. Enter your Ring login details and click Next.
   4. Select the security cameras you would like to include and click Done.
   5. In your list of Things, look for devices named "Ring: [Device Name]"

SmartThings IDE GitHub Integration:

To use this installation method, you will need a GitHub account. If you have not set up GitHub integration for SmartThings IDE, take a look at the SmartThings documentation.

1. Add a new GitHub Repository:
   1. From either the "My Device Handlers" or "My SmartApps" sections click on Settings.
   2. Under GitHub Repositories, click Add new repository and enter the following information:
      • Owner: farhad-a
      • Name: smartthings-ring
      • Branch: master
   3. Click Save.
2. Create the SmartApp:
   1. Go to My SmartApps and click Update from Repo.
   2. Select smartthings-ring (master).
   3. In the New (only in GitHub) section, check the box next to ../ring-security-cams-connect.groovy.
   4. Check the Publish checkbox.
   5. Click Execute Update.
3. Create the custom device handler for the lights:
   1. Go to My Device Handlers and click Update from Repo.
   2. Select smartthings-ring (master).
   3. In the New (only in GitHub) section, check the box next to ../ring-security-cam.groovy.
   4. Check the Publish checkbox.
   5. Click Execute Update.
4. In your SmartThings mobile app:
   1. Tap Automation → SmartApps → Add a SmartApp.
   2. Scroll all the way down and tap My Apps, then Ring Security Cams (Connect).
   3. Enter your Ring login details and click Next.
   4. Select the security cameras you would like to include and click Done.
   5. In your list of Things, look for devices named "Ring: [Device Name]"

If there is an update available, in the SmartApp/Device Handler list of SmartThings IDE, the SmartApp and/or device handler will turn Magenta. To update repeat steps 2 and 3. The only difference is the SmartApp/Device Handler displays in the Obsolete (updated in GitHub) section.