SmartThings Web Device Status Badge

WHAT IT DOES

SmartThings Web Device Status Badge reads device status and connectivity from your SmartThings web dashboard and displays a floating device status badge on all pages. The badge shows the number of online devices, total devices, and the number of offline devices with a red indicator. A status badge shows whether all devices are online or if some are offline. The panel displays a room/category breakdown showing online/offline counts per room. The extension tracks device status changes over time, storing each status change with a timestamp per device. When a device goes offline, a desktop notification is triggered. The panel displays the current device status summary and room breakdown.

WHERE IT RUNS

This extension works on all SmartThings pages at smartthings.com and its subdomains, specifically on the web dashboard and device management pages. It runs on the main dashboard, the device list page, and any page displaying device status information. The extension operates entirely within your browser and does not access SmartThings' servers directly—it reads only what is visible on the page you are viewing. It works alongside the free BotGentz extension, which provides the necessary scripting environment.

HOW TO USE

Install the extension, then navigate to smartthings.com and open your dashboard. The extension automatically creates a floating device status badge on the page. Click the extension's icon in your browser toolbar to open the settings panel. Use the "Show Overlay" / "Hide Overlay" button to toggle the badge visibility. The badge shows your online/offline device status. Use the "Refresh" button to manually update the badge with the latest device information. The "Show offline devices" toggle controls whether offline devices appear in the breakdown. The "Status change notifications" toggle controls desktop notifications when devices go offline. Adjust the overlay transparency using the opacity dropdown (70%, 82%, 92%, or 100%). Drag the badge by clicking and holding anywhere inside it. Resize it by dragging the bottom-right corner. Close the badge with the × button.

DEVICE STATUS DETECTION WITH PER-DEVICE HISTORY TRACKING

Unlike simple status counters, this extension uses a multi-selector extraction engine to find device items and their status from SmartThings' varying page structures. It searches for devices using multiple selector patterns (.device-item, .device-card, .device-tile) and falls back to text parsing. Status detection checks status elements for keywords like "online," "on," or "active" to determine online status, and falls back to class-based detection when status elements aren't found. Rooms are extracted from room, location, or category elements. Each device's status history is stored as an array of records with timestamps, limited to 20 entries per device. When a device status changes from online to offline, a notification is triggered with a one-hour cooldown. The room breakdown aggregates device status per room for easy monitoring.

THE PANEL

The panel supports drag-to-move anywhere on the page. It remembers its position per site, so it stays where you placed it on smartthings.com. Click the panel header to collapse it down to just the minimized bubble, or click the expand handle to show the full panel. The panel can be resized by dragging the bottom-right corner. Press the Escape key to close the expanded panel and return to the minimized state. All panel settings, including position, size, collapsed state, opacity, offline devices visibility, notification preference, and device history, are saved per site and persist across browsing sessions.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and active, as it provides the underlying DOM injection and script execution environment. SmartThings' website changes periodically, and device element structures, class names, and page layouts may be updated. When that happens, the extension may stop detecting device status until an update is released. The extension stores your overlay position, size, opacity, visibility, offline devices preference, notification preference, and per-device status history locally in your browser's storage using GM_setValue. Device history is stored as a key-value object where keys are device IDs and values are arrays of status records with timestamps. The device status displayed is read from the page—the extension does not access SmartThings' internal device data. Always verify with SmartThings directly for the most accurate device status information. No data is ever sent to any server, and no personal information is collected. You can clear all stored settings at any time by clearing your browser data for smartthings.com.