sonoscli

by Unknown v1.0.0

The sonoscli skill allows you to manage and control your Sonos speakers directly from the command line. It provides functionalities such as discovering speakers, checking their status, controlling playback (play, pause, stop), adjusting volume, and managing speaker groups. It also supports listing and playing favorites, managing the queue, and even searching Spotify via the SMAPI interface.

This tool is ideal for automating Sonos control or integrating it into scripts and workflows. It simplifies common tasks such as grouping speakers for a party or quickly adjusting the volume of a specific speaker in your home.

Note that Spotify Web API search is optional and requires `SPOTIFY_CLIENT_ID/SECRET` environment variables to be set.

What It Does

The sonoscli skill enables command-line control of Sonos speakers, allowing users to discover speakers, check their status, control playback (play, pause, stop), adjust volume, manage speaker groups, list and play favorites, manage the queue, and search Spotify.

When To Use

Use this skill when you want to automate Sonos speaker control, integrate Sonos functionality into scripts, or prefer a command-line interface for managing your Sonos system. This is useful for home automation setups, custom audio workflows, or simply controlling your speakers without relying on the Sonos app.

Inputs

Command-line arguments specifying actions (play, pause, volume, etc.) and speaker names or IP addresses.

Outputs

Status updates, success/failure messages, and changes to Sonos speaker settings (volume, playback state, grouping).

Limitations

Requires the 'sonos' command-line tool to be installed. Spotify search functionality is optional and requires Spotify API credentials. SSDP discovery may fail in some network configurations, requiring manual IP address specification.

Installation

1. Install Go on your system: [https://go.dev/dl/](https://go.dev/dl/)
2. Open a terminal and run: `go install github.com/steipete/sonoscli/cmd/sonos@latest`.
3. Add the Go binary directory (usually `$HOME/go/bin` or `%USERPROFILE%/go/bin`) to your system's PATH environment variable.

View Cline documentation

1. Install Go on your system: [https://go.dev/dl/](https://go.dev/dl/)
2. Open a terminal and run: `go install github.com/steipete/sonoscli/cmd/sonos@latest`.
3. Add the Go binary directory (usually `$HOME/go/bin` or `%USERPROFILE%/go/bin`) to your system's PATH environment variable.

View Aider documentation

Have a Skill to Share?

Join the community and help AI agents learn new capabilities. Submit your skill and reach thousands of developers.