Listing your music service in the Service Catalog

Listing your music service in the Service Catalog

The Sonos Music Service Catalog is the list of services that appear when a listener clicks Add Music Services from the Sonos menu:

SMAPI Partners provide this information to Sonos using the SMAPI Service Application found under the Develop & Submit tab. To enter the information view your application in the Version Manager, click Edit and fill out the appropriate fields in section B: Technical Configuration & Test Setup. See below for a list and descriptions of these fields. Click Save in the application to save changes.

Service Logo Icons

Service logo icons are displayed on various screens on the controller to identify your service. While you can provide either PNG or SVG formats, SVG format is preferred for future controllers as this format allows more options for scalability across many differently-sized controllers. See Service Logo Guidelines for details.

Icons: Legacy Controllers Icons: Hi-Res Controllers

Legacy Controllers

Add URLs for service logo icons in PNG format for legacy controllers, in the following sizes:

  • 18 pixels (px)
  • 24 px
  • 36 px
  • 48 px
  • 54 px
  • 72 px

Hi-Res Controllers

Select the SVG image type in the list box and add URLs for service logo icons in SVG format for 40 px and 400 px. You can also supply icons in PNG format, but these may not be supported in future Sonos controllers. To do so, select the PNG image type in the list box and provide URLs for the following sizes:

  • 20 px
  • 40 px
  • 80 px
  • 112 px
  • 200 px
  • 400 px

UI Text

Enter information for the fields that will be displayed in the user interface (UI).

The following fields are required.

  • Languages: Select the languages that you will support. Note that you will have to add these to the strings.xml file. English is required.
  • Primary Language: Choose the primary language that will be used by your Music Service. Service Name: Enter the name of your Music Service, as you would like it to be listed, this field has a maximum of 50 characters.
  • Short call to action: Enter a call to action for your service to be used with your logo on the music section of the Sonos website. Add the URL to your service logo image for the Sonos website in section D: Marketing & Other General Questions. The maximum size is 164 x 88 pixels.
  • Short description: Enter a short description of your service, which will be displayed in the Music Services list, as shown below. This field has a maximum of 160 characters.
  • Long description: Enter a long description of your service, which will be displayed on the Add Service page for your service, as shown below. This field has a maximum of 4000 characters.
  • Sign up url: Enter the sign up URL for your service.

The UI screens from the Sonos Controller App for AndroidTM Smartphones are shown below.

Music Services list Add Service page

Social Media

Enter the URLs to your social media presence and website. These will be displayed as icons with links on the Add Service page for your service. These fields are optional.

  • Facebook: The URL for your Facebook page for your Music Service. HTTPS is encouraged.
  • Twitter: The URL for your Twitter account for your Music Service. HTTPS is encouraged.
  • Website: The URL for the website for your Music Service.