Harmony Hub Integration for Node-RED
Control your devices connected to a Logitech™ Harmony Hub from Node-RED.
Getting started
If you haven't done so yet, install Node-RED
sudo npm install -g node-red
There are two ways to install the extension: Via npm on the terminal or from within Node-RED in the browser.
Install via terminal and npm
In the terminal open the user data directory ˜/.node-red and install the package
cd ˜/.node-red
npm install node-red-contrib-harmony
Then run or restart Node-RED
node red
Open your Node-RED instance, typically under http://localhost:1880, and you should see the new nodes available in the palette in the group harmony.
Install via Node-RED
You can install the extension simply in Node-RED in your browser, by default under http://localhost:1880. Click on the Menu button (sandwich icon) in the upper right corner. In the menu click Manage palette. In the side-panel that opens on the left click on the tab Install. In the search field enter harmony, in the result list a node-red-contrib-harmony card will appear. Click on the install button on this card, and you are done. You should now find the new nodes available in the palette in the group harmony.
Usage / Available nodes
Three nodes are available in Node-RED: H command, H activity, and H observe, located in the group harmony.
H command
A node to send a Command to a Harmony Hub through Node-RED.
A Harmony Hub needs to be selected from the list or created by clicking on the edit button. The Harmony Hub IP address can be autodetected by clicking on the search button in the configuration node.
An Activity or Device that is set up on the Harmony Hub needs to be selected. The dropdown loads available activities and devices automatically, if needed the list can be refreshed by clicking on the refresh button next to the dropdown. Selecting an activity or device changes the available commands below, therefore you'll need to reselect a command below.
A Command needs to be selected. The dropdown loads available commands for the selected activity or device automatically, if needed the list can be refreshed by clicking on the refresh button next to the dropdown.
The Repeat field allows for the command to be repeated. The default is 1, meaning the command is send once. For example entering 10 will send the command exactly 10 times. This can be helpful when using commands for volume or channels.
The delay field allows for a ms delay between press and release The presstimestamp field controls the timestamp sent to the api on press The releasetimestamp field controls the timestamp sent to the api on release
The command configured in the node will be triggered by any input injected into the node, the output slot will return msg.payload = true if the command was sent successfully.
H press
A node to send a button press to a Harmony Hub through Node-RED.
A Harmony Hub needs to be selected from the list or created by clicking on the edit button. The Harmony Hub IP address can be autodetected by clicking on the search button in the configuration node.
An Activity or Device that is set up on the Harmony Hub needs to be selected. The dropdown loads available activities and devices automatically, if needed the list can be refreshed by clicking on the refresh button next to the dropdown. Selecting an activity or device changes the available commands below, therefore you'll need to reselect a command below.
A Command needs to be selected. The dropdown loads available commands for the selected activity or device automatically, if needed the list can be refreshed by clicking on the refresh button next to the dropdown.
The Repeat field allows for the command to be repeated. The default is 1, meaning the command is send once. For example entering 10 will send the command exactly 10 times. This can be helpful when using commands for volume or channels. The timestamp field controls the timestamp sent to the api
The command configured in the node will be triggered by any input injected into the node, the output slot will return msg.payload = true if the command was sent successfully.
H release
A node to send a button release to a Harmony Hub through Node-RED.
A Harmony Hub needs to be selected from the list or created by clicking on the edit button. The Harmony Hub IP address can be autodetected by clicking on the search button in the configuration node.
An Activity or Device that is set up on the Harmony Hub needs to be selected. The dropdown loads available activities and devices automatically, if needed the list can be refreshed by clicking on the refresh button next to the dropdown. Selecting an activity or device changes the available commands below, therefore you'll need to reselect a command below.
A Command needs to be selected. The dropdown loads available commands for the selected activity or device automatically, if needed the list can be refreshed by clicking on the refresh button next to the dropdown.
The Repeat field allows for the command to be repeated. The default is 1, meaning the command is send once. For example entering 10 will send the command exactly 10 times. This can be helpful when using commands for volume or channels. The timestamp field controls the timestamp sent to the api
The command configured in the node will be triggered by any input injected into the node, the output slot will return msg.payload = true if the command was sent successfully.
H hold
A node to send a button hold to a Harmony Hub through Node-RED.
A Harmony Hub needs to be selected from the list or created by clicking on the edit button. The Harmony Hub IP address can be autodetected by clicking on the search button in the configuration node.
An Activity or Device that is set up on the Harmony Hub needs to be selected. The dropdown loads available activities and devices automatically, if needed the list can be refreshed by clicking on the refresh button next to the dropdown. Selecting an activity or device changes the available commands below, therefore you'll need to reselect a command below.
A Command needs to be selected. The dropdown loads available commands for the selected activity or device automatically, if needed the list can be refreshed by clicking on the refresh button next to the dropdown.
The Repeat field allows for the command to be repeated. The default is 1, meaning the command is send once. For example entering 10 will send the command exactly 10 times. This can be helpful when using commands for volume or channels. The timestamp field controls the timestamp sent to the api The command configured in the node will be triggered by any input injected into the node, the output slot will return msg.payload = true if the command was sent successfully.
H activity
A node to activate an Activity on a Harmony Hub through Node-RED
A Harmony Hub needs to be selected from the list or created by clicking on the edit button. The Harmony Hub IP address can be autodetected by clicking on the search button in the configuration node.
An Activity that is set up on the Harmony Hub needs to be selected. The dropdown loads available activities automatically, if needed the list can be refreshed by clicking on the refresh button next to the dropdown.
To switch off, select PowerOff from the Activity dropdown list, or enter "-1" into the field.
The command configured in the node will be triggered by any input injected into the node, the output slot will return msg.payload = true if the command was sent successfully.
H GetActivity
A node to get the numeric ID of the current Activity
H observe
A node to observe an Activity being triggered on a Harmony Hub through Node-RED
A Harmony Hub needs to be selected from the list or created by clicking on the edit button. The Harmony Hub IP address can be autodetected by clicking on the search button in the configuration node.
When an Activity is switched on the Harmony Hub, the node sends an object with a payload to the output:
payload: { activityId: activityId, activityStatus: activityStatus }
The activityId is the ID of the current activity, the activityStatus represents the following states:
0 = Hub is off, 1 = Activity is starting, 2 = Activity is started, 3 = Hub is turning off.
Built With
- NodeJS - JavaScript runtime built on Chrome's V8 JavaScript engine.
- Node-RED - for wiring together hardware devices, APIs and online services.
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request.
Authors
- Stefan Krüger - Initial work - Aietes
- Daniel Freese - Coding help - AirBorne04
- ** Martin Walker ** - this fork - [marsjupiter1]https://github.com/marsjupiter1)
License
This project is licensed under the MIT License - see the LICENSE.md file for details
Acknowledgments
This Node-RED module is based on the great work of Manuel Alabor swissmanu and Daniel Freese AirBorne04, using his harmonyhub client and discover libraries.