Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
**Summary:** This version improves playback queue logic and introduces input sanitisation for safer command execution. - Added input sanitisation before running any shell commands to prevent command injection. - Enhanced YouTube search output to include track duration, improving user selection and queue management. - Introduced queue-first playback: user requests now build an audio queue by default unless an explicit list/order is given.
What This Skill Does
RoomSound plays audio to Bluetooth speakers by combining YouTube search and streaming with Bluetooth device management. It resolves search queries to stream URLs, builds contextual queues targeting 90 minutes of audio, and switches speaker output by alias. Runs on Linux using yt-dlp, mpv, and bluetoothctl.
Combines YouTube audio search, stream resolution, queue building, and Bluetooth speaker switching in one agent skill, eliminating the need to juggle separate apps or terminal sessions.
When to use it
- Playing lo-fi music on a Bluetooth speaker by asking in plain language
- Switching audio output from a desk speaker to kitchen speakers mid-session
- Building an auto-queued background playlist without manually picking tracks
- Listing all paired Bluetooth speakers and checking which are connected
- Queuing a specific set of YouTube URLs to play back in order
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: "Play some jazz on the kitchen speaker"
- 1Search YouTube with yt-dlp for jazz tracks and retrieve titles, durations, and URLs
- 2Resolve stream URLs for enough tracks to fill at least 90 minutes
- 3Look up the 'kitchen' alias and retrieve its stored Bluetooth MAC address
- 4Disconnect any currently connected speakers and connect the kitchen device
- 5Start mpv with the resolved stream URLs in queue order
Jazz playlist begins playing through the kitchen Bluetooth speaker