Skip to content

hklages/node-red-contrib-sonos-plus

Repository files navigation

node-red-contrib-sonos-plus

npm npm Maintenance GitHub license Donation

A set of Node-RED nodes to control SONOS player in your local network.

Works well with Home Assistant (see example) and with its sister package node-red-contrib-sonos-events, handling SONOS events / subscriptions.

This package is in no way connected to or supported by Sonos Inc.

Highlights

  • Play your track, album, playlist, station from Spotify, Napster, Amazon, Deezer and other music content provider.

  • My Sonos, Music-Library (NAS shares), SONOS-Playlists and SONOS-Queue are supported.

  • Control your player: play, stop, pause - modify the SONOS queue.

  • Change player setting such as volume, mute state, alarms, loudness, treble, bass, the LED and more.

  • Group players by using their SONOS-Playernames.

  • Group commands automatically address the coordinator in that group

  • DNS names are supported in config node (ipv4 address should still work)

Explore the full scope in the Wiki.

NEWS (cumulative, recent)

  • new EXPERIMENTAL command player.play.clip

  • New command household.set.alarm

  • household.add.subwoofer now support non - HT systems

  • bugfixing artUri for some apple tracks

  • New commands household.add.subwoofer, household.add.satellites, household.remove.satellites (removing surroundsystem commands)

  • New commands player.get.subwoofer / player.set.subwoofer

QUICKSTART - DEGUG - SUPPORT

There is a Quickstart guide in the Wiki and example flows in Node-RED Import - Examples.

Set the ENV variable DEBUG for debugging (example DEBUG=nrcsp:universal). Usage is described here. Prefix: nrcsp: and available keywords: universal|mysonos|config|commands|extensions|helper|discovery.

Open a GitHub issue (preferred method) or send an email (German/English).

Installation

Install directly from your Node-RED's setting palette.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Credentials

svrooij node-sonos-ts for the excellent API.