blucli

What This Skill Does

The blucli skill provides a command-line interface (CLI) to interact with and control Bluesound and NAD networked audio players. This allows users to manage their audio devices directly from the OpenClaw AI agent. You can discover available devices, check their current status, control playback (play, pause, stop), adjust volume levels, and manage speaker groupings. The skill also includes specific features for searching and playing content from TuneIn, a popular internet radio service.

For scripting and automated tasks, the --json flag is recommended for structured output. The skill prioritizes target device selection through explicit command-line arguments (--device), environment variables (BLU_DEVICE), or a configured default device. It emphasizes confirming the target device before making any playback changes, promoting safe and intentional control of your audio environment.

Installation

To install the blucli skill, use the following command within your OpenClaw environment:

clawhub install openclaw/openclaw/skills/blucli

This command fetches the skill from the official openclaw/openclaw repository.

Use Cases

• Device Discovery and Status: Quickly find all connected Bluesound/NAD players on your network and see what's currently playing on each.
• Playback Control: Manage music playback across your devices – start, stop, or pause songs with simple commands.
• Volume Management: Set specific volume levels for individual players or groups.
• Speaker Grouping: Create or modify speaker groups to play synchronized audio across multiple rooms.
• Internet Radio: Search for stations on TuneIn and immediately start streaming your favorite broadcasts.
• Automation: Integrate audio control into scripts for home automation scenarios, such as dimming lights and starting a specific playlist at a scheduled time.
• Troubleshooting: Quickly check device status and playback information to diagnose audio issues.

Example Prompts

• "Show me all connected Bluesound devices and their current status."
• "Set the volume on the Living Room speaker to 20 and play my 'Chill Vibes' playlist."
• "Find 'NPR' on TuneIn and play it on the Kitchen speaker."

Tips & Limitations

• Target Selection: Always be mindful of which device you are controlling. Use blu devices to see available devices and their IDs. Explicitly specify the target device using --device <id|name|alias> or ensure the BLU_DEVICE environment variable is set correctly, especially when performing actions like volume changes or playback control. Confirm the target device before executing critical commands.
• JSON Output: For use in scripts or automated workflows, leverage the --json flag for machine-readable output. This is crucial for parsing responses and integrating blucli into larger automation systems.
• Network Dependency: This skill relies on your local network to communicate with Bluesound/NAD devices. Ensure all devices are on the same network and that network configurations do not prevent communication.
• Device Compatibility: While designed for Bluesound and NAD players, compatibility with very old or obscure models is not guaranteed. Refer to the blu project's documentation for a comprehensive list of supported devices.
• TuneIn Limits: The TuneIn search and play functionality is dependent on the TuneIn service itself. Availability and search results may vary.