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

License

MIT