sonoscli

What This Skill Does

The sonoscli skill serves as a powerful command-line interface for interacting with Sonos audio ecosystems directly from the OpenClaw environment. It simplifies the discovery, control, and management of multi-room audio hardware. By abstracting the complexity of the UPnP and SSDP protocols, it allows users to perform common audio tasks like volume adjustment, playback control, and grouping of speakers without needing proprietary mobile applications. It acts as an bridge between your AI agent and your home network infrastructure, enabling automation and smart control of your media playback devices.

Installation

To integrate this skill into your environment, use the OpenClaw hub command. Ensure that your agent has network access to the local subnet where your Sonos devices reside. Execute the following command in your terminal: clawhub install openclaw/skills/skills/steipete/sonoscli

Use Cases

This skill is perfect for users seeking to automate their home audio environment. Common use cases include integrating music playback into daily 'Morning Routine' automations, adjusting background audio based on active projects or focus modes, and managing complex multi-room speaker grouping for social events or parties. It is also an excellent tool for developers building smart home dashboards or voice-activated media assistants that require granular control over hardware states, such as checking current track information or managing playback queues.

Example Prompts

1. "Check the current status of the Kitchen speaker and set the volume to 20."
2. "Search for the latest jazz tracks on Spotify and play them on my Office speaker."
3. "Group the Living Room and Kitchen speakers together into party mode."

Tips & Limitations

• Connectivity: The skill relies on SSDP for device discovery. If your speakers are on a different VLAN or if your network environment blocks multicast traffic, you must use the --ip flag to manually define the target device.
• Performance: For Spotify integration, ensure you have configured SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET in your environment variables to enable the SMAPI search functionality.
• Network: This tool is strictly for local network control. It cannot communicate with your speakers if they are on a remote network or outside of your local broadcast domain unless advanced routing is configured.