Commands

sonos watch

GitHub Edit page

sonos watch

Subscribes to UPnP eventing on the target speaker and prints state changes as they arrive. Ctrl+C to stop. Useful for debugging, dashboards, or piping into another script.

#Synopsis

sonos watch --name "<Room>" [--duration 30s] [--format plain|json]

#Flags

FlagDefaultWhat it does
--duration duration0Stop after this duration. 0 = until Ctrl+C.

Plus all global flags.

#Examples

sonos watch --name "Kitchen"
sonos watch --name "Kitchen" --duration 30s
sonos watch --name "Kitchen" --format json | jq -r '.event'

#How it works

  1. Spins up a local HTTP server (the callback).
  2. Sends SUBSCRIBE requests to AVTransport/Event and RenderingControl/Event on the speaker.
  3. Renders each NOTIFY body as a structured event line.
  4. On exit, sends UNSUBSCRIBE so the speaker stops calling back.

#Firewall

The speaker has to be able to reach your machine on the chosen callback port. On macOS / Windows you'll likely see a firewall prompt the first time. Allow it, or limit the rule to your Sonos VLAN.

If your network blocks inbound from the Sonos subnet, eventing won't work — fall back to polling sonos status.