blucli

The BluOS CLI (blu) is a specialized automation tool designed for users of Bluesound and NAD multi-room audio systems. It provides a direct, scriptable interface to interact with networked audio players, bridging the gap between hardware controls and terminal-based workflows. Whether you are automating your home audio environment, managing multi-room synchronization, or integrating audio status into your personal AI assistant dashboards, this tool provides the necessary hooks for granular control. It is intended for power users, home automation enthusiasts, and developers who require programmatic access to audio playback state without relying on proprietary mobile applications.

• Full control over playback states including play, pause, stop, and skip functionality.

• Advanced multi-room grouping capabilities: dynamically add or remove players from groups and check current group status.

• Real-time device discovery and selection using custom identifiers, aliases, or environment variables like BLU_DEVICE.

• Direct access to streaming services such as TuneIn, allowing users to search and trigger playback of radio stations and media content via the CLI.

• Volume management with specific level setting capabilities.

• JSON output support, specifically engineered for integration with shell scripts, automation pipelines, and AI agent toolsets.

• Ensure all target players are on the same local network as the host machine for successful discovery.

• Use the --json flag for automated parsing and programmatic consumption of device status reports.

• Confirm the active target device using the devices command before executing playback changes to avoid accidental interference with unintended players.

• This tool is highly effective when mapped as an action or skill within a local AI assistant, enabling voice-controlled or context-aware audio management.

• Requires consistent networking; ensure your firewall settings permit communication with the BluOS discovery ports.

• Ideal for building automated routines such as 'morning music' triggers or 'all-stop' shutdown commands in a smart home environment.