duncan3dc/sonos

Control Sonos speakers using a simple API

3.0.0 2026-06-11 11:19 UTC

Requires

• php: ^8.1
• ext-soap: *
• ext-sockets: *
• duncan3dc/cache: ^1.0 || ^2.0
• duncan3dc/domparser: ^2.2.1
• duncan3dc/sonos-common: ^1.0
• duncan3dc/speaker: ^1.0
• guzzlehttp/guzzle: ^6.0 || ^7.0
• league/flysystem: ^3.7
• league/flysystem-local: ^3.0
• psr/log: ^1.1 || ^2.0 || ^3.0
• psr/simple-cache: ^1.0 || ^2.0 || ^3.0

Requires (Dev)

• duncan3dc/object-intruder: ^0.3 || ^1.0
• maglnet/composer-require-checker: ^4.0
• mockery/mockery: ^1.5
• monolog/monolog: ^2.10 || ^3.0
• nikic/php-parser: ^4.13
• phpstan/phpstan: ^2.2
• phpstan/phpstan-mockery: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpunit/phpunit: ^10.0
• squizlabs/php_codesniffer: ^4.0

Apache-2.0

• Craig Duncan

• streaming
• sonos
• upnp

README

A PHP library for interacting with Sonos speakers.

Full documentation is available at https://duncan3dc.github.io/sonos/
PHPDoc API documentation is also available at https://duncan3dc.github.io/sonos/api/

Getting Started

$sonos = new \duncan3dc\Sonos\Network();
$controllers = $sonos->getControllers();
foreach ($controllers as $controller) {
    echo $controller->getRoom() . " (" . $controller->getStateName() . ")\n";
}

Read more at https://duncan3dc.github.io/sonos/

Changelog

A Changelog has been available since version 0.8.8
This library was based on the great work done by both DjMomo/sonos and phil-lavin/sonos

Where to get help

Found a bug? Got a question? Just not sure how something works?
Please create an issue and I'll do my best to help out.
Alternatively you can connect with me on LinkedIn