homebridge-smartthings-v3

Homebridge dynamic platform plugin for Samsung SmartThings using a Personal Access Token (PAT).

Features

• Loads SmartThings devices via GET /v1/devices
• Updates status via GET /v1/devices/{id}/status
• Controls devices via POST /v1/devices/{id}/commands
• Supported device types:
  • Switch / Outlet / Lightbulb (including brightness via switchLevel)
  • Lock
  • Contact, Motion, Temperature, Humidity, Water Sensor

Requirements

• Homebridge >= 1.8.0
• Node.js >= 18
• SmartThings PAT with Devices Read/Write scope

Example Configuration

{
  "platforms": [
    {
      "platform": "SmartThingsPATPlatform",
      "name": "SmartThings",
      "token": "your_samsung_pat",
      "welcomeBanner": true,
      "refreshInterval": 60,
      "debug": false
    }
  ]
}

Instead of setting the token in JSON, you can also use an environment variable:

SMARTTHINGS_TOKEN=your_samsung_pat

Notes

• If includeDeviceIds is set, only those devices are created in Homebridge.
• Without filtering, all devices visible to the PAT are loaded.
• If welcomeBanner is true (default), the plugin prints an ASCII banner plus developer name, plugin version, and loaded device count after startup.
• You can replace the ASCII art directly in STARTUP_ASCII_BANNER in index.js.