SoCo (Sonos Controller) is a high level Python 3 library to control your Sonos ® speakers with:
# Import soco and get a SoCo instance
import soco
device = soco.discovery.any_soco()
# Get all albums from the music library that contains the word "Black"
# and add them to the queue
albums = device.music_library.get_albums(search_term='Black')
for album in albums:
print('Added:', album.title)
device.add_to_queue(album)
# Dial up the volume (just a bit) and play
device.volume += 10
device.play()To get up and running quickly with SoCo, start by reading the getting started <getting_started> page, with installation
instructions <installation> and a small tutorial <tutorial> and then wet your appetite with the micro examples
<examples>. Then optionally follow up with any of the advanced topics that pique your interest: speaker_topologies, events and upnp_services. Finally dive into the the full module
reference documentation <module_reference>.
If you have a question, start by consulting the FAQ <faq>. If your question remains unanswered, post a question in the SoCo/SoCo Gitter chat room or in the SoCo Google group.
If you are interested in participating in the development, plase read the
development documentation <development_topics> and file a bug or make a pull request on Github.
getting_started examples faq plugins authors
advanced/index
api/soco
releases/index
development/index
genindexmodindexsearch