SoCo 0.8 release notes

New Features

  • Re-added support for Python 2.6 (#154)

  • Added SoCo.get_sonos_playlists() (#114)

  • Added methods for working with speaker topology

  • soco.SoCo.group retrieves the soco.groups.ZoneGroup to which the speaker belongs (#132). The group itself has a soco.groups.ZoneGroup.member attribute returning all of its members. Iterating directly over the group is possible as well.

  • Speakers can be grouped using soco.SoCo.join() (#136):

    z1 = SoCo('192.168.1.101')
z2 = SoCo('192.168.1.102')
z1.join(z2)

  • soco.SoCo.all_zones and soco.SoCo.visible_zones return all and all visible zones, respectively.

  • soco.SoCo.is_bridge indicates if the SoCo instance represents a bridge.

  • soco.SoCo.is_coordinator indicates if the SoCo instance is a group coordinator (#166)

  • A new soco.plugins.spotify.Spotify plugin allows querying and playing the Spotify music catalogue (#119):

    from soco.plugins.spotify import Spotify
from soco.plugins.spotify import SpotifyTrack
# create a new plugin, pass the soco instance to it
myplugin = Spotify(device)
print 'index: ' + str(myplugin.add_track_to_queue(SpotifyTrack('
    spotify:track:20DfkHC5grnKNJCzZQB6KC')))
print 'index: ' + str(myplugin.add_album_to_queue(SpotifyAlbum('
    spotify:album:6a50SaJpvdWDp13t0wUcPU')))

  • A soco.data_structures.URI item can be passed to add_to_queue which allows playing music from arbitrary URIs (#147)

    import soco
from soco.data_structures import URI

soc = soco.SoCo('...ip_address...')
uri = URI('http://www.noiseaddicts.com/samples/17.mp3')
soc.add_to_queue(uri)

  • A new include_invisible parameter to soco.discover() can be used to retrieve invisible speakers or bridges (#146)

  • A new timeout parameter to soco.discover(). If no zones are found within timeout seconds None is returned. (#146)

  • Network requests can be cached for better performance (#131).

  • It is now possible to subscribe to events of a service using its soco.services.Service.subscribe method, which returns a soco.events.Subscription object. To unsubscribe, call the soco.events.Subscription.unsubscribe method on the returned object. (#121, #130)

  • Support for reading and setting crossfade (#165)

Improvements

  • Performance improvements for speaker discovery (#146)

  • Various improvements to the Wimp plugin (#140).

  • Test coverage tracking using coveralls.io (#163)

Backwards Compatability

  • Queue related use 0-based indexing consistently (#103)

  • soco.SoCo.get_speakers_ip() is deprecated in favour of soco.discover() (#124)