Skip to content

nomos-system/node-red-contrib-nomos

Repository files navigation

nomos system

node-red-contrib-nomos

A Node-RED integration for the nomos system Controller.

npm version License


Connect your nomos system Controller to Node-RED and build powerful automations with components, scenes, events and the full nomos system API at your fingertips.

Requirement: nomos system Controller 2.0 or newer.

Installation

Run the following command in your Node-RED user directory (typically ~/.node-red):

npm install node-red-contrib-nomos

Alternatively, install it directly via the Node-RED Palette Manager.

Configuration

  1. Drag a nomos node onto the flow.
  2. Open the node and create a new nomos-hub configuration if none exists yet.

Add nomos-hub configuration

nomos-hub settings

Usage

Components

Connect directly to components and devices managed by your nomos system Controller. Each node is bound to a specific property — pick the one that matches what you want to read or write:

Node Purpose
state Boolean on/off state of a component
level Level / brightness (0–100 %)
hue Color (hue/saturation) for lighting
volume Audio volume
position Blind / shutter position
angle Slat angle for blinds
setpoint Target temperature
temperature Measured temperature
humidity Measured humidity
isheating Heating state
iscooling Cooling state
motion Motion sensor
contact Contact / door sensor
openwindow Open-window detection
battery Battery level
reachable Reachability of a component
raw Raw component data
component Generic node — read/write any component property

Use the component node when no specialized node fits — it can access any property of any component.

Extras

Direct access to system-level objects configured on your Controller. Each node can act as a trigger (chain further Node-RED logic to it) or as an executor.

Node Purpose
event nomos events
timer nomos timers
scene nomos scenes
notificationprofile nomos notification profiles
hub Configuration node for the Controller

API

The complete nomos system API is exposed as Node-RED nodes — over 500 endpoints covering device management, configuration, monitoring and more. See the inline help of each node for detailed information.

Supported integrations & domains (click to expand)

Smart-Home protocols & ecosystems

KNX · Matter · Zigbee · Z-Wave · Hue · free@home · Somfy · Wiser · Zeptrion · Lutron · Sonos · Spotify · Miele · HomeConnect · Netatmo · Nuki · Husqvarna

System management

Backups · Cameras · Floors · Rooms · Links · Users · System variables · Special events · Webhooks · SIP clients · Monitoring · Accessories

Networking & remote access

VPN · WireGuard (server / clients / peers) · Port forwarding · Remote devices · Cloud sync · Management pairing

Add-ons & online library

Add-on profiles · Add-on devices · Online library profiles · Auto-detection

Maintenance

Logging · System debug · Software updates · Soft reset · Emergency mode · MCP tokens · Ping devices

License

MIT © nomos system AG

Contributors