blucli

The blucli skill is a specialized automation tool designed for users of Bluesound and NAD audio equipment. It bridges the gap between manual hardware interaction and programmatic control, allowing your AI assistant to manage multi-room audio systems seamlessly. By providing a clean interface over the native player protocols, it transforms complex network commands into simple, actionable tasks for discovery, playback, and synchronization. It is intended for audiophiles and home automation enthusiasts who want to integrate their premium audio setup into a broader, conversational AI workflow, enabling hands-free control of music and sound environments.

• Full support for Bluesound and NAD player discovery, status monitoring, and device identification.

• Seamless media control including play, pause, stop, and volume level adjustments.

• Advanced multi-room audio grouping functionality to add or remove players from synchronized zones.

• Integrated TuneIn support for searching and playing internet radio stations or streams directly via command.

• Native support for JSON output, making it ideal for script-based automation and pipeline integration.

• Flexible device target selection using IDs, names, or aliases, with environment variable support for BLU_DEVICE persistence.

• Always confirm the target device before issuing playback or volume commands to avoid unintended disruption in other zones.

• Use the --json flag when piping outputs into other OpenClaw plugins or system scripts to ensure clean data parsing.

• The skill relies on network-based communication; ensure your players are reachable on the local subnet to prevent discovery failures.

• For complex grouping tasks, check the status before adding or removing members to verify the current zone configuration.

• Supports standard command patterns such as blu devices, blu play, and blu volume set, providing a predictable experience for CLI users and automated agents alike.