homebridge-smartthings-ik
Advanced tools
Connects SmartThings devices to Homebridge. Automatically discovers devices.
This is a smartthings plugin for Homebridge. This requires no access to the legacy smartthings app, and doesn't require a lot of work to install. It will discover devices automatically as well as unregister devices that are removed from your smarttthings network. This is currently under development.
Fixed window shade support including webhook support for the window shade service. Added polling paramter for window shades, 'PollWindowShadesSeconds'
Corrected status handling for mult-component devices.
IMPORTANT: Multi-button devices get loaded into the home app with the button numbers not always in the order that they are on the device. Also, some devices, like the Aeotec Fob Remote will show 1 more button than there are on the device. This is because the device reports a main component with a button along with one component for each button. You will find that in this case, one of the buttons in the Home app acts as a master, so it will fire for any of the other buttons.
In order to see which buttons are which, you can observe the animation in the Home app as you press buttons so you know how to set up actions per button.
SmartThings Webhook support is now supported and open to all. See the announcement here.
Support for SmartThings webhook to support real-time update of device state changes. Support for webhooks is in closed beta at the moment, but will be made available soon.
Will ignore (warning will be shown) if a battery is returning null. Won't convert temp to celcius if it is being reported to in celcius.
Support for Leak (water) detectors.
Rearchitecte plugin to handle multi service devices. Changing the way services are added based on capabilities reported in Smartthings rather than the category, which may not be accurate and is an optional field.
There was a timing issue that could cause a crash upon startup.
If a lock or door is controlled from Smartthings, the state in HomeKit would not update properly.
Delay in updating state right after a command was sent.
Added contect sensor support. Also will stop polling after 5 failures in a row, but restore after 10 minutes to try and reconnect to a failed accessory.
Lights now update dynamically as well.
Switches are polled now, so updates will flow into home kit. Also some refactoring of code to make more efficient when polling devices with several associated characterstics / services.
Support for PresenceSensor. These sensors are mapped to Home Kit Occupancy Sensor.
If door lock is offline, it caused Homebridge to exit
If motion detector was offline, it resulted in an error that resulted in Homebridge exiting.
Motion detector was always returning motion after 1.3.1
If motion sensor becomes unresponsive, the plugin would cause Smartthings to restart. This has been fixed.
Support for motion sensors
Fixed type error
If a Smartthings switch is found, and it supports the 'switchLevel' capability, then treat it as a lightbulb.
Added control of lights that support color control and/or color temperature.
Fixed another lock state issue.
Fixed lock state issues.
Thanks to neegool, can now ignore devices. To do this, add "IgnoreDevices" to your config file, which is an array of strings.
Added continuous polling for garage doors.
When polling lock, update target state.
Will poll locks to continuously update. Added a new optional config value "PollLocksSeconds" to control how frequently we poll. Default is 10 seconds. A value of 0 will result in no polling.
Added support for Window Shades that support the Window Shade Level command.
Added support for locks.
When getting an unexpected state from a garage door, throw a communications exception.
Added the ability to specify locations to ignore. The locations are the names you set in the Smartthings App. See "How to configure" below to learn how to specify locations to ignore.
Config UI now works.
Currently, the following have been implemented, because that is what I have access to in my home. Supports: Switch, Lightbulb, Fan, Garage Door Opener, Locks and Window Shades that support the WindowShadeLevel command.
You will need to create a Smartthings personal access token. You can do that here: https://account.smartthings.com/tokens. Create a
new token and make sure it has all of the device permissions, and if you want to use the Ignore Locations feature, you must include the List Locations (r:locations) permission. Save your token and add it to the configuration.
By configuring the WebhookToken, the plugin will attempt to connect to the SmartThings
Webhook Server that we're running and wait for events. This will result in
the plugin ignoring the poll settings as polling will not occur.
This section should be added to the platforms array in your config.json file, but you can now edit using the config UI:
{
"Name": "Smartthings Plugin",
"AccessToken": "INSERT YOUR PERSONAL ACCESS TOKEN HERE",
"WebhookToken: "INSERT WEBHOOK TOKEN HERE",
"BaseURL": "https://api.smartthings.com/v1",
"GarageDoorMaxPoll": 40,
"PollLocksSeconds": 15,
"PollDoorsSeconds": 15,
"PollSensorsSeconds": 5,
"PollSwitchesAndLightsSeconds": 15
"platform": "HomeBridgeSmartThings",
"IgnoreLocations": [
"My location 1",
"My location 2"
],
"IgnoreDevices": [
"Device to ignore 1",
"Device to ignore 2"
]
}
The "IgnoreLocations" array may be omitted. This array can be used to specify location names, as confogured in the Smartthings app. All of the devices in these locations will be ignored and not added to Homebridge. If you add any IgnoreLocations after you had previously started Homebridge with this plugin, those devices will be removed. You may remove this section to have them added back in. IMPORTANT: your API token must have the "r:locations" permission in order to ignore locations.
You need to restart Homebridge when you make changes to this file.
FAQs
Connects SmartThings devices to Homebridge. Automatically discovers devices.
The npm package homebridge-smartthings-ik receives a total of 72 weekly downloads. As such, homebridge-smartthings-ik popularity was classified as not popular.
We found that homebridge-smartthings-ik demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket researchers found several malicious npm packages typosquatting Chalk and Chokidar, targeting Node.js developers with kill switches and data theft.
Security News
pnpm 10 blocks lifecycle scripts by default to improve security, addressing supply chain attack risks but sparking debate over compatibility and workflow changes.
Product
Socket now supports uv.lock files to ensure consistent, secure dependency resolution for Python projects and enhance supply chain security.