# SoCo/SoCo

SoCo (Sonos Controller) is a Python project that allows you to programmatically control Sonos speakers.

Repository: https://github.com/SoCo/SoCo
Canonical: https://ross.abutalabs.com/products/soco
Homepage: http://python-soco.com/
Language: Python
License: MIT
License Family: permissive
Last push: 2026-07-29T15:37:16+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 83, longevity 100
- inputs: {"age_days": 4921, "days_push": 35, "days_rel": 35, "gap_med": 50, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1608, forks 242 (observed 2026-08-28T04:05:10.652118+00:00)

## What it is
SoCo is a Python library for programmatically controlling Sonos speakers over the local network, supporting device discovery, playback control, volume, and track information. It is distributed on PyPI as 'soco' under the MIT license.

## Use cases
- control sonos speakers from python
- discover sonos zone players on my network
- play a url stream on a sonos speaker
- automate sonos volume and playback in a script
- get current track info from sonos
- build a custom sonos controller app

## When to choose
- you want to script or automate Sonos speaker control in Python
- you need network discovery of Sonos zones without knowing IPs
- you're building a custom home-automation integration with Sonos

## When to avoid
- you rely on streaming service authentication (Spotify, Apple Music, Amazon Music) which currently has known issues
- you need a ready-made GUI controller rather than a library
- you use Python older than 3.8

## Facets
- artifact type: library
- maturity: active
- function: sdk, audio-processing, networking
- domain: iot, developer-tools
- platform: python, cross-platform
- tags: sonos, smart-speakers, upnp, home-automation, music-control, audio, automation

## Member repositories
- SoCo/SoCo (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:10.652118+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:51:20.073947+00:00, confidence not recorded.
  - readme: https://github.com/SoCo/SoCo (fetched 2026-08-28T04:05:10.652118+00:00, sha 4a2f04a3b1de)
  - homepage: http://python-soco.com/ (fetched 2026-08-29T11:23:30.701715+00:00, sha 181ec2676593)
  - registry_pypi: https://pypi.org/pypi/soco/json (fetched 2026-08-29T11:23:30.711827+00:00, sha f53cbba01160)
- Data as of 2026-08-30T08:39:29.467469+00:00.