npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@jn-se/node-red-contrib-heos

v0.3.1

Published

Node-RED node for Denon HEOS devices and Denon Home.

Downloads

25

Readme

node-red-contrib-heos

Introduction

A HEOS Node for Node-RED.

Use this node to integrate your HEOS devices into your Node-RED flows. HEOS ist the multiroom audio system by Denon.

Denon HEOS vs. Denon Home

This node supports the legacy Denon HEOS (HS) devices and as well the newer Denon Home devices. Both the Denon HEOS and the Denon Home devices are based on the HEOS system.

Installation

If you have already Node-RED installed you can install the HEOS nodes via the editor. Go to the Node-RED menu and Manage palette. Then select the Install tab and search for the package node-red-contrib-heos.

Getting Started

This package offers nodes to send commands to the HEOS network and listen for responses.

HEOS devices are normally autodiscovered in the network. So there is no need to configure a gateway if your Node-RED installation has access to your network and can search for HEOS devices.

The connection it established to an arbitrary HEOS device in your network that will then act as the gateway. The commands for a player are not adressed to a specific HEOS devices with an IP adress. Instead all commands are send to the gateway device but all commands are equipped with a playerID as recipient. The HEOS network will itself route the command to the appropriate player.

Use the Quickstart Guide and follow the steps to set up your first HEOS flow in a few minutes.

There are also some example flows available in the examples folder:

HEOS Nodes

This package offers two types of nodes:

  • Generic nodes
  • Specific nodes

Generic Nodes

HEOS Command Node

Send a custom command to the HEOS network.

HEOS commands include the following configurations:

  • Command Group: The group of the command.
  • Command: The command.
  • Attributes: The configuration details for the specific command.

So this node is completely generic and can send any command to the HEOS network. For a complete reference of available commands please see the HEOS CLI reference linked at the bottom of this page.

For example to play or stop music use the following node configurations.

Play music

| Configuration Item| Value | | --- | ----------- | | Command Group | player | | Command | set_player_state | | Attributes | {"pid":your-player-id,"state":"play"} |

Stop music

| Configuration Item| Value | | --- | ----------- | | Command Group | player | | Command | set_player_state | | Attributes | {"pid":your-player-id,"state":"stop"} |

HEOS Listener Node

Listen for specific change events in the HEOS network.

HEOS change events include the following configurations:

  • Command Group: The group of the command.
  • Command: The command.

So this node is completely generic and can get any change event available in the HEOS network. For a complete reference of available events please see the HEOS CLI reference linked at the bottom of this page.

The data of the change event can be read from the output in the msg.heos attribute.

For example to register player state events (like play, pause and stop) or player volume events use the following node configurations.

Get Player State Events

| Configuration Item| Value | | --- | ----------- | | Command Group | event | | Command | player_state_changed |

Get Player Volume Events

| Configuration Item| Value | | --- | ----------- | | Command Group | event | | Command | player_volume_changed |

Specific Nodes

Specific nodes are more easy to use than the generic command node. Simply configure the playerID and the command.

Nodes available:

  • HEOS Player State Node
  • HEOS Player Volume Node

More nodes will follow in the next releases.

HEOS Player State Node

Send a player state command that allows you to quickly send states to a player.

Allowed states are:

  • play
  • pause
  • stop

HEOS Player Volume Node

Send a player volume command that allows you to quickly change the volume level of a player.

Allowed levels are integer values between 0 and 100.

Roadmap

This node is currently under development. There is a roadmap of some tasks to be done for the next releases.

Version 1.x

  • Review & stabilization.
  • Add tests.
  • Add more nodes.
  • Review player groups and check generel conditions.

External Documentation