mirror of
https://github.com/wkulhanek/bonob.git
synced 2025-12-21 17:33:29 +01:00
86 lines
2.4 KiB
Plaintext
86 lines
2.4 KiB
Plaintext
= Setting up Sonos Service
|
|
|
|
== Prerequisites
|
|
* In your Sonos App get your Sonos ID (About my Sonos System)
|
|
+
|
|
image::images/about.png[]
|
|
|
|
* Navidrome running and available from the server that Bonob is running on. This can be a public URL like https://music.mydomain.com or just a local URL like http://192.168.1.100:4533.
|
|
* Bonob running and available from the Internet. E.g. via https://bonob.mydomain.com
|
|
|
|
You can use any method to make these URLs available. Cloudflare Tunnels, Pangolin, reverse proxy, etc.
|
|
|
|
== Sonos Service Integration
|
|
|
|
* Log into https://play.sonos.com
|
|
* Once logged in go to https://developer.sonos.com/s/integrations
|
|
|
|
* Create a *New Content Integration*
|
|
|
|
** General Information
|
|
*** Service Name: Navidrome
|
|
*** Service Availability: Global
|
|
*** Checkbox checked
|
|
*** Website/Social Media URLs: https://music.mydomain.com (Some URL - e.g. your Navidrome server). This has to be a valid URL.
|
|
|
|
** Sonos Music API
|
|
*** Integration ID: com.mydomain.music (your domain in reverse)
|
|
*** Configuration Label: 1.0
|
|
*** SMAPI Endpoint: https://bonob.mydomain.com/ws/sonos
|
|
*** SMAPI Endpoint Version: 1.1
|
|
*** Radio Endpoint: empty
|
|
*** Reporting Endpoint: https://bonob.mydomain.com/report/v1
|
|
*** Reporting Endpoint Version: 2.3
|
|
*** Authentication Method: OAuth
|
|
*** Redirect: https://bonob.mydomain.com/login
|
|
*** Auth Token Time To Life: Empty
|
|
*** Browse/Search Results Page Size: 100
|
|
*** Polling Interval: 60
|
|
|
|
** Brand Assets
|
|
|
|
*** Just upload the various assets from the `sonos_artwork` directory.
|
|
|
|
** Localization Resources
|
|
|
|
*** Write something about your service in the various fields (except Explicit Filter Description).
|
|
|
|
** Integration Capabilities
|
|
|
|
*** Check the first two (*Enable Extended Metadata* and *Enable Extended Metadata for Playlists*) and nothing else.
|
|
|
|
** Image Replacement Rules
|
|
|
|
*** No changes
|
|
|
|
** Browse Options
|
|
|
|
*** No changes
|
|
|
|
** Search Capabilities
|
|
|
|
*** API Catalog Type: SMAPI Catalog
|
|
*** Catalog Title: Music
|
|
*** Catalog Type: GLOBAL
|
|
|
|
*** Add Three Categories with ID and Mapped ID:
|
|
+
|
|
Albums - albums
|
|
Artists - artists
|
|
Tracks - tracks
|
|
|
|
** Content Actions
|
|
|
|
*** No changes
|
|
|
|
** Service Deployment Settings
|
|
|
|
*** Sonos ID: Your Sonos ID (from About my system). This is how only your controller sees the new service.
|
|
*** System Name: Whatever you want
|
|
|
|
** Service Configuration
|
|
|
|
*** Click on *Refresh* and then *Send*. You should get a success message that you can dismiss with *Done*.
|
|
|
|
* In your app search for your service name and add Service in your app as usual.
|