PHPackages                             gustav/sonos - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. gustav/sonos

ActiveLibrary[API Development](/categories/api)

gustav/sonos
============

Control Sonos speakers using a simple API

2.2.0(5y ago)04Apache-2.0PHPPHP ^7.4

Since May 29Pushed 5y agoCompare

[ Source](https://github.com/GustavSoftware/sonos)[ Packagist](https://packagist.org/packages/gustav/sonos)[ Docs](https://github.com/duncan3dc/sonos)[ RSS](/packages/gustav-sonos/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (1)Dependencies (15)Versions (89)Used By (0)

sonos
=====

[](#sonos)

A PHP library for interacting with [Sonos](http://www.sonos.com/) speakers.

Full documentation is available at
PHPDoc API documentation is also available at [http://duncan3dc.github.io/sonos/api/](http://duncan3dc.github.io/sonos/api/namespaces/duncan3dc.Sonos.html)

[![release](https://camo.githubusercontent.com/b81f05e1afa55fb5b0de3e2a98c85234150195d1b2bc0825693811636aa7d47e/68747470733a2f2f706f7365722e707567782e6f72672f64756e63616e3364632f736f6e6f732f76657273696f6e2e737667)](https://packagist.org/packages/duncan3dc/sonos)[![build](https://camo.githubusercontent.com/9d40522a7a17522bb747f726e269f057df7cb49da54d3fc1c89462b8670470cc/68747470733a2f2f7472617669732d63692e6f72672f64756e63616e3364632f736f6e6f732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/duncan3dc/sonos)[![coverage](https://camo.githubusercontent.com/1e9c288fc9e7157793c5cb1edd4ceae9b1720a4eb65a2d0842902d71e4962074/68747470733a2f2f636f6465636f762e696f2f67682f64756e63616e3364632f736f6e6f732f67726170682f62616467652e737667)](https://codecov.io/gh/duncan3dc/sonos)

Quick Examples
--------------

[](#quick-examples)

Start all groups playing music

```
$sonos = new \duncan3dc\Sonos\Network;
$controllers = $sonos->getControllers();
foreach ($controllers as $controller) {
    echo $controller->name . " (" . $controller->room . ")\n";
    echo "\tState: " . $controller->getState() . "\n";
    $controller->play();
}
```

Add all the tracks from one playlist to another

```
$sonos = new \duncan3dc\Sonos\Network;
$protest = $sonos->getPlaylistByName("protest the hero");
$progmetal = $sonos->getPlaylistByName("progmetal");

foreach ($protest->getTracks() as $track) {
    $progmetal->addTracks($track["uri"]);
}
```

*Read more at *

Changelog
---------

[](#changelog)

A [Changelog](CHANGELOG.md) has been available since version 0.8.8

Where to get help
-----------------

[](#where-to-get-help)

Found a bug? Got a question? Just not sure how something works?
Please [create an issue](//github.com/duncan3dc/sonos/issues) and I'll do my best to help out.
Alternatively you can catch me on [Twitter](https://twitter.com/duncan3dc)

duncan3dc/sonos for enterprise
------------------------------

[](#duncan3dcsonos-for-enterprise)

Available as part of the Tidelift Subscription

The maintainers of duncan3dc/sonos and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/packagist-duncan3dc-sonos?utm_source=packagist-duncan3dc-sonos&utm_medium=referral&utm_campaign=readme)

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 97.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~28 days

Recently: every ~121 days

Total

79

Last Release

2181d ago

Major Versions

0.8.8 → 1.0.02014-12-30

1.9.x-dev → 2.0.02018-07-21

PHP version history (6 changes)0.0.1PHP >=5.4.0

1.4.0PHP >=5.5.0

1.7.0PHP >=5.6.0

1.9.5PHP ^5.6|^7.0

2.0.0PHP ^7.1

2.2.0PHP ^7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/2e94b9c2235f7f12553818a7f94540eedaa2026a287d07ef12e1315ca559941a?d=identicon)[ckoecher](/maintainers/ckoecher)

---

Top Contributors

[![duncan3dc](https://avatars.githubusercontent.com/u/546811?v=4)](https://github.com/duncan3dc "duncan3dc (309 commits)")[![fdp2](https://avatars.githubusercontent.com/u/7798051?v=4)](https://github.com/fdp2 "fdp2 (2 commits)")[![Nibbler73](https://avatars.githubusercontent.com/u/18286191?v=4)](https://github.com/Nibbler73 "Nibbler73 (2 commits)")[![tobiaskluge](https://avatars.githubusercontent.com/u/2651934?v=4)](https://github.com/tobiaskluge "tobiaskluge (2 commits)")[![rlerdorf](https://avatars.githubusercontent.com/u/54641?v=4)](https://github.com/rlerdorf "rlerdorf (1 commits)")[![scottpashley](https://avatars.githubusercontent.com/u/16228214?v=4)](https://github.com/scottpashley "scottpashley (1 commits)")[![0bp](https://avatars.githubusercontent.com/u/586405?v=4)](https://github.com/0bp "0bp (1 commits)")

---

Tags

streamingsonosupnp

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gustav-sonos/health.svg)

```
[![Health](https://phpackages.com/badges/gustav-sonos/health.svg)](https://phpackages.com/packages/gustav-sonos)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[algolia/algoliasearch-client-php

API powering the features of Algolia.

69735.1M159](/packages/algolia-algoliasearch-client-php)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k43](/packages/civicrm-civicrm-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)