Search for music via Brave Search and play it on Sonos speakers. Supports play, current track, and speaker discovery.
Sonos Music Search Skill
Search for music via Brave Search and play it on your Sonos speakers directly from the command line.
Features
- Search for Spotify tracks using Brave Search
- Play found tracks on a specified Sonos speaker
- View the currently playing track
- List available Sonos speakers on the network
- Safe search enabled by default (opt into unrestricted with
--unsafe)
Prerequisites
- Node.js >= 18
- A Brave Search API key (get one here)
- At least one Sonos speaker on the same network
Installation
npm install
Configuration
Set your Brave Search API key as an environment variable:
export BRAVE_API_KEY=your-api-key
Usage
Play a track
node src/index.js play "Living Room" "pink floyd comfortably numb"
Add --unsafe to disable safe search:
node src/index.js play "Living Room" "explicit track name" --unsafe
View currently playing track
node src/index.js current "Living Room"
List available speakers
node src/index.js list
Programmatic API
const { searchAndPlay, getCurrentTrack, listSpeakers } = require('sonos-music-search-skill');
// Play a track
const result = await searchAndPlay('Living Room', 'pink floyd comfortably numb');
// { success: true, track: '...', speaker: 'Living Room', uri: 'spotify:track:...' }
// Get current track
const track = await getCurrentTrack('Living Room');
// { title: '...', artist: '...', ... }
// List speakers
const speakers = await listSpeakers();
// [{ name: 'Living Room', host: '192.168.1.50' }, ...]
Scripts
| Command | Description |
|---|---|
npm start | Run the CLI |
npm run audit | Run the skill audit |
npm run format | Format JS and Markdown files |
npm run format:check | Check formatting without writing |
License
MIT
Related skills
- Downloads
- 903All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.1.1
- License
- MIT-0
