Sonos: Plugin Installation

To Install:
  1. Download and extract to the Downloads directory on the Indigo server.
  2. Double-click on the package to install.
To Configure:
  • You will be presented with the plugin configuration dialog upon initial installation.  If upgrading, access the plugin configuration dialog from the Indigo Plugins menu.

  1. Reference ZonePlayer IP: Enter the IP address of any active ZonePlayer on the network. It is used to retrieve playlists, and other music server attributes.  This should not be the ip address of a Sonos Bridge, Boost, Subwoofer, or any ZonePlayer that is part of a surround sound grouping.  For most reliable performance, select a ZonePlayer that is physically plugged in using the ethernet port.  To find the ip addresses of all ZonePlayers, select “About My Sonos System” from the Sonos menu in the Sonos desktop controller or the Settings option in the mobile app.
  2. Event Processor: This is the library used (with some enhancements) to manage subscriptions to state updates from all ZonePlayers.  Currently, SoCo is the only option available so not much to do here.
  3. Event Listener IP Address: This is the IP address that is used to listen for ZonePlayer events as well as validate that subscriptions are still valid.  It should be set the IP address of your Indigo server.  The plugin will listen on port 1900 for UPNP announcements from all ZonePlayers.  It operates in a shared mode.  There are some plugins that also use port 1900 and do not share the port.  This will create a problem for the plugin.
  4. HTTP Streaming IP: The plugin spawns a simple HTTP server to stream MP3 or AIFF files to a ZonePlayer or group of ZonePlayers.  It is used for the Announcement actions.  Populate with “auto” to attempt to automatically figure out the IP address.  If the plugin reports issues on startup, simply entree the IP address of the Indigo server.
  5. HTTP Streaming Port: This the TCP port that goes along the with the IP address above.  It will default to 8888, but can be changed to another port if this conflicts with an existing service on the Indigo server.
  6. Sound File Path: If you wish to play static MP3 files as part of an announcement to a ZonePlayer, enter the path of those files here.  The plugin will read the path on startup and scan for MP3 files in the directory specified.  Note that the path will be read on the Indigo server itself.
  7. Pandora: Check this box if you have an active Pandora account configured on the Sonos system.  You will then enter your Pandora email address and password.  You can also choose a short name to appear in dropdown menus.  This helps to distinguish between multiple Pandora accounts.
  8. Second Pandora: Check this box if you have a secondary Pandora account configured on the Sonos system.  Enter corresponding parameters as you did in the prior step.
  9. Sirius XM: Check this box if you have an active SiriusXM account configured on the Sonos system.  You will then enter your SiriusXM ID and password.
  10. IVONA: IVONA has been deprecated by Amazon in favor of Polly.  It will be removed in a future version of the plugin.
  11. Polly: Check this box if you have a registered user account with Amazon Polly and wish to use it for group announcements.  You will need an Access Key and Secret Key.  Information can be found here:
  12. Microsoft Translate: Microsoft Translate has been deprecated by Microsoft in favor of Azure announcements.  This may be supported in a future version of the plugin.
  13. Email Update Notifications: Check this box if you want to enable version update notifications.  Email sending must also be configured in Indigo’s preferences.
  14. Debugging: There are four levels of debugging available.  Activate these cautiously when requested to troubleshoot issues.