Sonos Music Search Skill#

Search for music on Spotify via Brave Search and play it on your Sonos speakers — right from the command line.

Features#

• 🔍 Uses Brave Search API to find Spotify tracks
• 🔊 Plays found tracks on your specified Sonos speaker
• 🎶 View currently playing track
• ⏱️ Discovery timeout protection (won't hang on missing speakers)
• 🛡️ Safe search defaults to moderate

Prerequisites#

• Node.js >= 18
• Brave Search API key — Get one here
• Sonos speaker on the same local network
• Spotify account linked to your Sonos system

Installation#

bash

npm install

Configuration#

Set your Brave Search API key:

bash

export BRAVE_API_KEY=your-api-key

Usage#

Play a track#

bash

node src/index.js play "Living Room" "pink floyd comfortably numb"

View currently playing track#

bash

node src/index.js current "Living Room"

Scripts#

CommandDescriptionnpm startRun the CLInpm run formatFormat JS and Markdown filesnpm run format:checkCheck formatting without writing

License#

MIT