smarthomebrain

n8n node for SmartHomeBrain smart home platform

Package Information

Released: 3 mo ago
Downloads: 214 weekly / 784 monthly
Latest Version: 0.2.1

Available Nodes

SmartHomeBrain Trigger icon
SmartHomeBrain Trigger
Triggers workflows on a device state change or button press for triggerable devices (switches, motion/presence sensors, remotes, etc.)
SmartHomeBrain icon
SmartHomeBrain
Control SmartHomeBrain devices and query state

Documentation

n8n-nodes-smarthomebrain

n8n community nodes for the SmartHomeBrain smart home platform.

Nodes

SmartHomeBrain Trigger

Subscribes to the device-manager WebSocket and fires your workflow when a device changes state or a button is pressed. Filters by device, device type, and area, then narrows with a Trigger On mode:

Trigger On Fires when Adaptive fields
Any Change (default) Any capability change or button press matching the filters above — (matches previous node behavior)
Specific Capability Field One field of one capability meets a condition Capability and Field dropdowns only list what the selected device actually declares; Condition adapts to the field's type — booleans get Changed / Becomes True / Becomes False, numbers get Changed / Crosses Above / Crosses Below / Changes By At Least (with a Threshold), closed-vocabulary strings (lock state, thermostat mode, presence event) get Changed / Equals (with a Value dropdown)
Button Press A specific button + gesture fires Button and Action dropdowns only list the buttons/gestures the selected device's profile declares

"Specific Capability Field" and "Button Press" require picking one exact Device above (not "Any Device") — that's what makes the dropdowns adaptive. "Crosses Above"/"Crosses Below" are edge-triggered (fire once per crossing, not on every reading already past the threshold).

Output fields:

Field Type Description
id / deviceId string System device ID
slug string Human-friendly slug, e.g. hallway-motion
deviceName string Friendly name
deviceType string e.g. motion, switch, light
areaId / areaName string | null Area ID / display name
capabilities array Full current capability state, e.g. [{ kind: 'OccupancySensing', occupancy: true }]
events array | undefined Button press(es) that matched, for Button Press mode / Any Change with a remote
availability string online / offline / unknown
timestamp string ISO 8601 timestamp

SmartHomeBrain

Action node with four operations:

Operation What it does
Send Command POSTs a command. Target picks who receives it:
• Single Device — resolves a device slug → ID, same as before.
• Multiple Devices — hand-pick any set of devices from a checklist; the same command is sent to each. Each targeted device gets its own output item (deviceId/slug included), and a device that fails doesn't discard results already collected from the others — with Continue On Fail off, the first failure still aborts the run, but successes already emitted are kept.
Capability narrows to what's actually usable: for a single device, its live reported state → matched code profile → device-type default. For multiple devices, the intersection across every selected device, so only commands guaranteed to work for all of them show up.
Get Device State Returns the current merged state of all devices
List Devices Returns all adopted devices (one item per device)
List Areas Returns all synced areas

Installation

In n8n → Settings → Community Nodes → Install → enter:

n8n-nodes-smarthomebrain

Or via CLI inside the n8n container:

npm install n8n-nodes-smarthomebrain

Restart n8n after installing.

Credential setup

  1. In n8n → Credentials → New → search SmartHomeBrain API
  2. Fill in:
    • Host URL: the address of your device-manager, e.g. http://192.168.10.30:3001
    • API Key: paste a key from the dashboard → Settings → API Keys
  3. Click Test — you should see SmartHomeBrain is reachable and healthy

Creating your first API key

On first visit to the SmartHomeBrain dashboard, the setup wizard runs automatically. If you already have access:

  1. Open the dashboard → API Keys (key icon in sidebar)
  2. Click Generate New Key → give it a name (e.g. n8n)
  3. Copy the full key (shb_…) — it's shown only once
  4. Paste it into the n8n credential

Example workflow

[SmartHomeBrain Trigger]          [SmartHomeBrain]
  Device:      hallway-motion →     Operation:   Send Command
  Trigger On:  Specific Capability  Device:      living-room-light
  Capability:  OccupancySensing     Capability:  OnOff
  Field:       Occupancy            Command:     on
  Condition:   Becomes True

With "Becomes True" the trigger only fires on the false→true edge, so no IF node is needed to gate it — wire the trigger straight into the command.

Development

# Type-check
pnpm typecheck

# Tests
pnpm test

# Build
pnpm build

# Publish
npm publish

Discussion