blucli

blu communicates directly with Bluesound/NAD players on your local network. Target a device by flag, environment variable, or saved default — then issue commands:Run blu devices to discover all players on your network and pick a target.Set a default target with --device <id|name|alias>, the BLU_DEVICE environment variable, or a saved config default.Issue playback, volume, or grouping commands — they go straight to the selected player.Add --json to any command for machine-readable output, ideal for scripting and automation pipelines.

Device Discovery — Automatically find all Bluesound and NAD players on your local network with blu devices.Playback Control — Play, pause, and stop any player with simple one-word commands.Volume Management — Set precise volume levels instantly, e.g. blu volume set 15.Multi-Room Grouping — Check group status, add players to a group, or remove them with blu group status|add|remove.TuneIn Integration — Search and play TuneIn internet radio stations directly from the CLI.Flexible Targeting — Address devices by ID, name, or alias via flag, environment variable, or saved config default.Script-Friendly JSON Output — Append --json to any command for structured output suited to automation and scripting.

Bluesound or NAD Player — A Bluesound or NAD network audio player on your local network is required. The blu CLI communicates with these devices directly; no cloud account or API key is needed.

Home Automation Scripts — Trigger playback, adjust volume, or switch rooms as part of a larger home automation workflow using shell scripts or task schedulers.Multi-Room Audio Management — Quickly group and ungroup Bluesound players across rooms without reaching for a phone.Internet Radio on Demand — Search TuneIn and start playing a station with a single command, ideal for morning routines or timed playback.Developer Tooling — Use --json output to integrate Bluesound control into custom dashboards, status monitors, or CI/CD hooks.