Sonos api documentation for the local UPNP api and a generator to generate clients and documentation based on service discovery
This library is in no way connected to Sonos. It's just a set of text files to document a hidden and unsupported api.
Check-out the (generated) documentation about all the SONOS UPNP services svrooij.io/sonos-api-docs/services/
We cannot get all the information by using service discovery, there is one file that we manually edit to document some the actions (accepting pull-request to improve).
- View/edit source source documentation.json
- Download documentation.json
This file has a documentation json schema which means VS Code will guide you when editing this file.
You can find the generator here and use it to generate your own sonos client in your preferred language.
You can use the generator to generate your own discovery files, but we also have the files available for download.
- Sonos Play:1 - software generation 1
- Sonos Play:5 - software generation 1
- Sonos Playbar - software generation 1
These files toghether with the documentation file, are combined to a extensive JSON file, that is used as an input for the generator.
The generator uses handlebars.js templates to generate the documentation/strong typed clients. Check-out the docs template as a sample to develop your own templates.
A template is a folder with a template.json file, that describes the template and specifies what templates should be used to either generate an index (all services in a single file), or a seperate file for each service.
If you need help building an app that talks to your sonos speakers, or you want to share some of your findings. Join us on Discord.
Thanks goes to these wonderful people (emoji key):
 Stephan van Rooij 💻 📖 🤔 🚧 |
 H. Klages 📖 |
 Sebastian Schuberth 📖 |
This project follows the all-contributors specification. Contributions of any kind welcome!