# sonoscli

> Control Sonos speakers (discover/status/play/volume/group). Use this skill when the user wants to control audio playback, manage speaker groups, or interact with their Sonos system.

- Author: albertmusic102
- Repository: dlmmedia/agent-orchestrator
- Version: 20260126105354
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/dlmmedia/agent-orchestrator
- Web: https://mule.run/skillshub/@@dlmmedia/agent-orchestrator~sonoscli:20260126105354

---

---
name: sonoscli
description: Control Sonos speakers (discover/status/play/volume/group). Use this skill when the user wants to control audio playback, manage speaker groups, or interact with their Sonos system.
homepage: https://sonoscli.sh
metadata: {"architect":{"emoji":"🔊","requires":{"bins":["sonos"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/sonoscli/cmd/sonos@latest","bins":["sonos"],"label":"Install sonoscli (go)"}]}}
---

# Sonos CLI - Architect Agent Skill

Control Sonos speakers on your local network using the `sonos` CLI tool.

## Installation

```bash
# Install via Go
go install github.com/steipete/sonoscli/cmd/sonos@latest

# Or via Homebrew (if available)
brew install sonoscli
```

## Quick Start

### Discover Speakers

```bash
# Find all Sonos speakers on the network
sonos discover

# Output shows speaker names and IPs
```

### Basic Playback Control

```bash
# Check current status
sonos status --name "Living Room"

# Play/Pause/Stop
sonos play --name "Living Room"
sonos pause --name "Living Room"
sonos stop --name "Living Room"

# Volume control (0-100)
sonos volume set 25 --name "Living Room"
sonos volume up --name "Living Room"      # +5
sonos volume down --name "Living Room"    # -5
```

## Speaker Groups

Manage multi-room audio by grouping speakers.

```bash
# View current groups
sonos group status

# Join a speaker to another's group
sonos group join --name "Kitchen" --coordinator "Living Room"

# Remove from group
sonos group unjoin --name "Kitchen"

# Party mode - group all speakers
sonos group party

# Solo mode - ungroup all speakers
sonos group solo
```

## Favorites & Playlists

```bash
# List all favorites
sonos favorites list

# Play a favorite
sonos favorites open --name "My Playlist" --speaker "Living Room"
```

## Queue Management

```bash
# View queue
sonos queue list --name "Living Room"

# Play specific queue item
sonos queue play --index 3 --name "Living Room"

# Clear queue
sonos queue clear --name "Living Room"
```

## Spotify Integration (Optional)

Requires `SPOTIFY_CLIENT_ID` and `SPOTIFY_CLIENT_SECRET` environment variables.

```bash
# Search Spotify
sonos smapi search --service "Spotify" --category tracks "artist name song"

# Play from Spotify
sonos smapi play --service "Spotify" --uri "spotify:track:xxxxx" --name "Living Room"
```

## Common Use Cases

### Play Music in Multiple Rooms

```bash
# Group speakers first
sonos group join --name "Kitchen" --coordinator "Living Room"
sonos group join --name "Bedroom" --coordinator "Living Room"

# Play music (plays on all grouped speakers)
sonos play --name "Living Room"
```

### Set Morning Alarm Volume

```bash
sonos volume set 15 --name "Bedroom"
sonos favorites open --name "Morning Jazz" --speaker "Bedroom"
```

### Quick Party Setup

```bash
sonos group party
sonos volume set 40 --name "Living Room"
sonos favorites open --name "Party Mix" --speaker "Living Room"
```

## Troubleshooting

- **SSDP Discovery Fails**: Use `--ip <speaker-ip>` to specify speaker directly
- **Connection Issues**: Ensure Sonos speakers and your machine are on the same network
- **Spotify Not Working**: Verify environment variables are set correctly

## Reference

- Homepage: https://sonoscli.sh
- GitHub: https://github.com/steipete/sonoscli