← Back to Skills Marketplace
RoomSound
by
icecat2005
· GitHub ↗
· v0.1.5
555
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install roomsound
Description
RoomSound gives your agent the skill to play audio to your speakers. Starting with YouTube to Bluetooth speakers, expanding to local files and other sources.
Usage Guidance
RoomSound appears coherent for its purpose, but before installing or initializing it you should: 1) Be prepared to approve package installations (sudo apt install) and verify packages come from your distro's repos; 2) Expect the agent to enumerate Bluetooth devices and store MAC addresses as alias mappings—if you are privacy-conscious, decide whether you want those stored and where; 3) Confirm any automatic changes to audio sinks or default devices (wpctl/pactl) are acceptable; 4) If you prefer tighter control, run the apt installs and create the yt-dlp config yourself and only grant the agent permission to execute the playback commands; 5) If you are uncomfortable with autonomous agent actions, restrict the skill to user-invoked only or disable autonomous invocation in your agent configuration.
Capability Analysis
Type: OpenClaw Skill
Name: roomsound
Version: 0.1.5
The skill bundle is designed for audio playback and Bluetooth speaker control, utilizing standard tools like `yt-dlp`, `mpv`, and `bluetoothctl`. All commands executed are directly aligned with the stated purpose, and there is no evidence of data exfiltration, persistence mechanisms, or unauthorized network activity. Crucially, the `SKILL.md` file explicitly instructs the AI agent to perform input sanitization using `tr -d` on user-supplied text before interpolating it into shell commands, demonstrating a clear intent to prevent command injection vulnerabilities. File system modifications are limited to creating a user-specific `yt-dlp` configuration file, which is a standard and non-malicious operation.
Capability Assessment
Purpose & Capability
The skill's name/description (play audio to speakers, starting with YouTube/Bluetooth) matches the declared binaries (yt-dlp, mpv, bluetoothctl) and the apt packages suggested (yt-dlp, mpv, bluez, pulseaudio-utils). There are no unrelated credentials, binaries, or config paths requested.
Instruction Scope
SKILL.md instructs the agent to run local system commands (bluetoothctl, wpctl/pactl, yt-dlp, mpv), build queues, and persist speaker alias → MAC mappings and a small yt-dlp config (~/.config/yt-dlp/config). These actions are within the skill's domain, but they do involve enumerating Bluetooth devices (MAC addresses) and writing user config/agent memory—both are privacy-relevant and worth informing the user about.
Install Mechanism
This is an instruction-only skill with no external installers. The only install instruction is to use the system package manager (apt) for well-known packages; no downloads from untrusted URLs or archive extraction are specified.
Credentials
No environment variables or external credentials are requested. The only persisted data is local aliases and a yt-dlp config; those are proportional to the feature set but contain device identifiers (MACs), which are sensitive.
Persistence & Privilege
The skill will write a yt-dlp config (~/.config/yt-dlp/config) and persist alias→MAC mappings in agent memory/config, and may run apt install (requires elevated privileges). These behaviors are reasonable for speaker control, but installing packages and changing default sinks are privileged actions — the user should expect install prompts and confirm before allowing them.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install roomsound - After installation, invoke the skill by name or use
/roomsound - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.5
**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.
v0.1.3
- Removed bluetoothctl trust <MAC>
v0.1.1
- Now describes YouTube search-to-play as a two-step approach: first get the audio stream URL, then play it with mpv.
- Reducing vulnerability surface
v0.1.0
Initial release of RoomSound — home audio control for agents:
- Enables speaker discovery, switching, and YouTube audio playback through simple commands.
- Supports Bluetooth speaker management using aliases for easy device switching.
- Handles YouTube search/playback via `yt-dlp` and `mpv` with natural-language prompts for ambiguous actions.
- Automatically installs and verifies required dependencies on first use.
- Provides clear user feedback and confirmation before changing audio outputs.
- Summarizes current speakers and sinks for quick device status checks.
Metadata
Frequently Asked Questions
What is RoomSound?
RoomSound gives your agent the skill to play audio to your speakers. Starting with YouTube to Bluetooth speakers, expanding to local files and other sources. It is an AI Agent Skill for Claude Code / OpenClaw, with 555 downloads so far.
How do I install RoomSound?
Run "/install roomsound" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is RoomSound free?
Yes, RoomSound is completely free (open-source). You can download, install and use it at no cost.
Which platforms does RoomSound support?
RoomSound is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created RoomSound?
It is built and maintained by icecat2005 (@icecat2005); the current version is v0.1.5.
More Skills