spotifylisted

# Spotify Use the `spotify` bridge to control Spotify playback via `spogo` on the host. ## When to Use - User asks to play, pause, skip music - Searching for songs, albums, artists, playlists - Managing playback devices or queue - Checking what's currently playing ## When NOT to Use - Apple Music -> not supported - Sonos playback -> use sonos bridge - Local audio files -> not supported ## Critical Rules 1. **Only run `spogo` commands** through `host_execute`. Never run `sleep`, `echo`, or any non-spogo command through the spotify bridge — they will be blocked by the gateway allowlist. 2. **Always verify playback after `spogo play`** — run `spogo status --json` and check that `is_playing` is `true` and the correct track is loaded. Never tell the user "it's playing" without verifying. 3. **Use `--device` flag** when targeting a specific device, especially if `spogo play` fails with "missing device id". ## Commands All commands run via `host_execute(bridge="spotify", command="...")`. ### Play by Name (most common workflow) **IMPORTANT:** `spogo play` requires a Spotify URI, not a name. Follow this exact sequence: 1. Search: `spogo search track "song name" --json` (or artist/album/playlist) 2. Extract the `uri` field from the first result 3. Play: `spogo play <uri>` 4. **Verify:** `spogo status --json` — check `is_playing: true` and correct track name 5. If `is_playing: false`, see "Known Issues" below ### Playback ``` spogo status