This is a module for the MagicMirror².
MagicMirror module that connects to the Samsung Smartthings api to display device status information.
This fork has been modified by Cydergoth to use a two column layout, move the icon position and suppress the value for locks. These changes make it more suitable for a smaller display, especially if you use short names for your sensors.
- An installation of MagicMirror2
- npm
- smartthings-node
cd ~/MagicMirror/modules
git clone https://github.com/buzzkc/MMM-Smartthings.git
cd MMM-Smartthings
npm install
To use this module, add the following configuration block to the modules array in the config/config.js
file:
var config = {
modules: [
{
module: "MMM-Smartthings",
position: "top_left",
header: "Smartthings",
config: {
personalAccessToken: 'your_smarthings_api_key',
capabilities: [
'contactSensor',
'lock'
],
title: "Doors & Locks",
excludedDeviceNames: [
'Sense-', // Contains this text
'Virtual Lock Test' // Or is a specific device label
]
}
}
]
}
Option | Description |
---|---|
personalAccessToken |
Required Setup your personal access token at https://account.smartthings.com/tokens |
capabilities |
Required An array of device capabilities to display statuses for. Supported capabilities: "switch", "contactSensor", "lock", "temperatureMeasurement", "relativeHumidityMeasurement", & "motionSensor" |
updateInterval |
Optional The number of milliseconds between updates Type: int (milliseconds) Default 30000 milliseconds (30 seconds) |
title |
Optional The sub-heading title for device list |
excludedDeviceNames |
Optional An array of device names or strings contained in the device label, can be excluded by containing a given word or the full name. Be more specific if devices you want to see are getting excluded. |
tempLowValue |
Optional The low threshold for temperature monitoring Default: 65 Type: int |
tempHighValue |
Optional The high threshold for temperature monitoring Default: 80 Type: int |
title |
Optional The sub-heading title for device list |
- Refactor to allow multiple instances of module.
- Add additional capabilities: https://docs.smartthings.com/en/latest/capabilities-reference.html
- Filter by location, currently all devices for all locations shown.
Filter out by device name.
- MichMich for developing MagicMirror2
- To the following for feedback and support sdetweil, cowboydude, & johnnyboy
- Examples on aduyng's MMM-IOTStatus project: