Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hklages/node-red-contrib-sonos-plus

A set of Node-RED nodes to control SONOS player in your local network.
https://github.com/hklages/node-red-contrib-sonos-plus

node-red sonos

Last synced: 3 months ago
JSON representation

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

Awesome Lists containing this project

README 

        
## node-red-contrib-sonos-plus



[![npm](https://img.shields.io/npm/dt/node-red-contrib-sonos-plus.svg)](https://www.npmjs.com/package/node-red-contrib-sonos-plus)

[![npm](https://img.shields.io/npm/v/node-red-contrib-sonos-plus.svg)](https://www.npmjs.com/package/node-red-contrib-sonos-plus)

[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://GitHub.com/Naereen/StrapDown.js/graphs/commit-activity)

[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/hklages/node-red-contrib-sonos-plus/master/LICENSE)

[![Donation](https://img.shields.io/badge/donation-cappuccino-orange)](https://www.buymeacoffee.com/hklages)



A set of [Node-RED](https://nodered.org/) nodes to control [SONOS](https://www.sonos.com/) player in your local network.



Works well with [Home Assistant](https://www.home-assistant.io/) (see example) and with its sister package [node-red-contrib-sonos-events](https://www.npmjs.com/package/node-red-contrib-sonos-events), handling SONOS events / subscriptions.



This package is in no way connected to or supported by [Sonos Inc.](https://www.sonos.com/de-de/impressum)



### 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.](https://github.com/hklages/node-red-contrib-sonos-plus/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](https://github.com/hklages/node-red-contrib-sonos-plus/wiki#quickstart) and example flows in Node-RED `Import - Examples`.



Set the ENV variable DEBUG for debugging (example `DEBUG=nrcsp:universal`). Usage is described [here](https://www.npmjs.com/package/debug). Prefix: `nrcsp:` and available keywords: `universal|mysonos|config|commands|extensions|helper|discovery`.



Open a GitHub issue (preferred method) or send an [email]([email protected]) (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](https://www.npmjs.com/package/@svrooij/sonos) for the excellent API.