roomsound

What This Skill Does

RoomSound serves as the primary audio orchestration layer for your OpenClaw agent. It bridges the gap between digital content and your physical audio hardware, transforming your AI agent into a sophisticated home media controller. By integrating directly with system audio stacks like PipeWire and PulseAudio, alongside control utilities like bluetoothctl and mpv, RoomSound enables seamless playback of YouTube content and system-wide audio stream management. It essentially acts as a localized media server, capable of discovering speakers, managing Bluetooth connections, and executing high-fidelity playback commands with minimal latency.

Installation

Installation is handled natively by the OpenClaw platform. To get started, execute the command: clawhub install openclaw/skills/skills/icecat2005/roomsound. Upon initial execution, the skill will perform a diagnostic check to ensure dependencies like yt-dlp, mpv, and bluez are present. If dependencies are missing, the skill will automatically prompt for a standard system installation. The setup includes a critical configuration step for the YouTube downloader, which establishes a stable JavaScript runtime for reliable video metadata retrieval and streaming, ensuring your agent can always fetch the latest audio content without errors.

Use Cases

RoomSound is ideal for users who want to centralize their media playback through natural language. Use it to shift background music from your primary workstation speakers to high-quality Bluetooth living room speakers without ever touching a mouse. It is also perfect for hands-free YouTube listening; simply ask for a playlist or a specific track, and the agent handles the search, queueing, and playback execution. It is particularly useful in smart-home environments where switching output devices based on user location or ambient noise levels is frequent.

Example Prompts

1. "Play some Lo-Fi beats for studying on my Living Room speakers."
2. "Switch my audio output to the Kitchen speaker, please."
3. "Search for the latest tech news summary on YouTube and play it through my current device."

Tips & Limitations

To maximize the utility of RoomSound, define friendly aliases for all your hardware during the first-run configuration phase. This prevents ambiguity when the agent attempts to connect to devices. Note that while RoomSound supports YouTube-based audio playback via mpv, it does not currently support multi-room synchronized playback across different hardware outputs simultaneously. If a speaker is not explicitly paired to your system, the agent cannot connect to it; always ensure your Bluetooth devices are in discoverable mode when performing the initial device discovery scan.