[RELEASE] Simple Device Viewer v2.0
New Features
-
Dashboard that allows you to see all the capability screens from any web browser. If you decide you want to use this feature, you need to enable OAuth in the App Settings.
-
New exclude list for each capability allows you to show a device on one screen and hide it from another. These settings are located in the “Display Settings” section.
-
The image location can be changed to a forked repository allowing you to use different icons. This setting is located in the “Other Settings” section.
-
The setting that allows you to choose which capabilities to show in the menu has been moved to the “Display Settings” section and it’s been reset to display all capabilities.
New Installtion Warning
When installing the SmartApp for the first time from the Marketplace, click “Done” when you get to the screen that says “Choose Devices” and then exit the Marketplace. You can then open it from the usual SmartApp location and configure everything.
This isn’t required, but it ensures you don’t spend a lot of time configuring everything and then lose all your changes because you accidentally tapped the back button and cancelled the installation.
Dashboard Feature
The dashboard allows you to view all your devices by capability the same way as the SmartApp, but it’s accessible from any web browser.
The Lights, Switches, and Alarms screens are interactive and allow you to toggle the state of those devices.
I made the Alarms screen interactive because if your siren is going off and the SmartApp is down, this might provide another way for you to turn them off.
The Switches and Lights screens have an option for “turn all on” and “turn all off”, but this feature may time out if you have a lot of devices.
Enabling the Dashboard
To use this feature you need to open the SmartApp from the “My SmartApps” screen in the IDE, click the “App Settings” button, and enable OAuth.
Once OAuth is enabled and you’ve selected at least one device from the “Choose Devices” section, you can enable the Dashboard by tapping the “Enable Dashboard” button on the main page.
Finding the Dashboard URL
The dashboard url gets written to Live Logging when you enable the dashboard and every time you open the “Dashboard Settings” screen.
You can also use the “View Dashboard” button on the main screen to open the dashboard and copy the url from the textbox at the bottom of the screen.
Don’t give this url out or show it in any screenshots you post to the forum because others can use it to view your dashboard. If you’re concerned that your URL has been compromised, you can go into the “Dashboard Settings”, disable the dashboard, and then enable it again.
If you want to have this dashboard and the IDE open at the same time, you need to use 2 different browsers. If you’re using Chrome, it might work in one browser if you’re in incognito mode.
Dashboard Settings
Dashboard Refresh Interval: When you have the dashboard open, this field determines how often the page should automatically refresh. It’s default value is 300 (5 minutes).
Default View: Determines which page should be displayed when you open it using the “View Dashboard” button in the SmartApp.
Menu Position: This determines if all the pages should display the menu above or below the device list.
Enter CSS rules that should be appended to the dashboard’s CSS file: This allows you to customize the look of the dashboard. For example, if you want a specific device to have a light blue background, you could make that happen by entering something like the following into this field.
.device-id-abcdefgh-1234-5555-asdf-aa2323sdsdsd{background-color:aliceblue;}
Disable Dashboard: This feature revokes the access token so that the dashboard url will no longer work. Re-enabling it will generate a new url for the dashbaord so if you have shortcuts setup for the dashboard, you’ll have to update them.