---
name: composio-community/Sonos CLI (sonoscli)
source: https://app.decimal.ai/s/composio-community-sonos-cli-sonoscli@1/SKILL.md
source_sha256: 580c1a11ff9a
---

# sonoscli — Control Sonos speakers from your terminal

Modern Go CLI for Sonos speaker control over your local network (UPnP/SOAP).

- **Repo**: https://github.com/steipete/sonoscli
- **Author**: [@steipete](https://github.com/steipete)

## Installation

```bash
brew install steipete/tap/sonoscli
```

Or build from source:

```bash
go install github.com/steipete/sonoscli/cmd/sonos@latest
```

## Requirements

- Machine must be on the same network as Sonos speakers
- Speakers reachable on TCP port 1400
- Spotify must be linked in Sonos app (for Spotify features)

## Key Commands

### Discovery & Status

```bash
sonos discover
sonos discover --format json
sonos status --name "Kitchen"
sonos now --name "Kitchen"
```

### Playback

```bash
sonos play --name "Kitchen"
sonos pause --name "Kitchen"
sonos stop --name "Kitchen"
sonos next --name "Kitchen"
sonos prev --name "Kitchen"
```

### Volume & Mute

```bash
sonos volume get --name "Kitchen"
sonos volume set --name "Kitchen" 25
sonos mute toggle --name "Kitchen"
```

### Speaker Grouping

```bash
sonos group status
sonos group join --name "Bedroom" --to "Living Room"
sonos group unjoin --name "Bedroom"
sonos group solo --name "Office"
sonos group party --to "Bar"          # all speakers join target
sonos group dissolve --name "Living Room"
```

### Queue Management

```bash
sonos queue list --name "Kitchen"
sonos queue play --name "Kitchen" 1    # play track at position
sonos queue remove --name "Kitchen" 3
sonos queue clear --name "Kitchen"
```

### Favorites

```bash
sonos favorites list --name "Kitchen"
sonos favorites open --name "Kitchen" --index 1
sonos favorites open --name "Kitchen" "BBC Radio 6 Music"
```

### Spotify

```bash
# Play a Spotify link
sonos open --name "Kitchen" https://open.spotify.com/track/6NmXV4o6bmp704aPGyTVVG

# Enqueue a playlist
sonos enqueue --name "Kitchen" spotify:playlist:37i9dQZF1DXcBWIGoYBM5M

# Search and play via SMAPI (no Spotify API credentials needed)
sonos play spotify --name "Office" "gareth emery"

# Search via Spotify Web API (needs SPOTIFY_CLIENT_ID/SECRET)
sonos search spotify --type track "daft punk harder better"
sonos search spotify --open --name "Kitchen" "miles davis so what"
```

### Scenes (Presets)

```bash
sonos scene save "Evening"
sonos scene apply "Evening"
sonos scene list
sonos scene delete "Evening"
```

### Play Arbitrary URI

```bash
sonos play-uri --name "Kitchen" "https://example.com/stream.mp3"
sonos tv --name "Living Room"       # switch to TV input
sonos linein --name "Kitchen" --from "Living Room"
```

### Watch Live Events

```bash
sonos watch --name "Kitchen"
sonos watch --name "Kitchen" --format json
```

## Output Modes

- `--format plain` (default)
- `--format json`
- `--format tsv`
- `--debug` for trace logs

## Configuration

```bash
sonos config set defaultRoom "Office"
sonos config set format json
sonos config get
```

Room targeting supports fuzzy substring matching — `--name "Kit"` matches "Kitchen".