Registry / iot / node-red-contrib-harmony-websocket

node-red-contrib-harmony-websocket

library2.2.6jsnpmunverified

A Node-RED contribution package (v2.2.6) that provides three nodes (HWS command, HWS activity, HWS observe) to control Logitech Harmony Hub devices over WebSocket. Released under the MIT license, it works around the firmware 4.15.206 breaking change. Alternatives include node-red-contrib-harmony (HTTP-based) and node-red-contrib-harmony-websocket-sc, but this package focuses on WebSocket communication with automatic IP discovery.

iot

npm install node-red-contrib-harmony-websocket

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · NODE-RED-CONTRIB-H

node-red-contrib-harmony-websocket

iotjavascriptv2.2.6

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

harmony-websocket nodes

✓ Nodes appear in Node-RED palette after install; not imported in code.

This is a Node-RED plugin, not a library. No JavaScript imports. Install via npm and use in Node-RED flows.

Installs the package into Node-RED user data directory, then restart Node-RED to see Harmony nodes.

cd ~/.node-red npm install node-red-contrib-harmony-websocket # Restart Node-RED node-red

Debug

Known issues

gotchaFirmware 4.15.206 breaking change: Logitech removed XMPP support; this package uses WebSocket as a workaround.

fix

Ensure using v2.x of this package; older versions relying on XMPP will not work.

affects: >=0.0.1

gotchaNode-RED dependency: Must be installed in Node-RED user directory (~/.node-red), not globally or in a separate project.

fix

Run `cd ~/.node-red && npm install node-red-contrib-harmony-websocket`.

affects: >=0.0.1

Errors

Common errors & fixes

Error: Cannot find module 'node-red-contrib-harmony-websocket'

Installed in wrong directory (e.g., global node_modules)

fix

Navigate to ~/.node-red and run npm install again.

Harmony Hub not found or connection timeout

Hub not on same subnet or firmware mismatch

fix

Ensure Hub is on same network and has firmware compatible with WebSocket (see package README).

Upgrade

Version history

2.2.6latest on npm

Audit

Dependencies

node-redrequiredRuntime required to use the nodes

Agent activity

23 hits · last 30 days

node

Resources

githubhttps://github.com/lopelex/node-red-contrib-harmony ↗

packagenode-red-contrib-harmony-websocket ↗

homepagehttps://github.com/lopelex/node-red-contrib-harmony#readme ↗