blucli

• You want to automate Bluesound or NAD player control from scripts, shell aliases, or AI agents without opening the BluOS app.
• You manage a multi-room audio setup and need to script grouping, playback changes, or volume adjustments across devices.
• You want to integrate TuneIn radio search and playback into a broader automation workflow.
• You prefer a fast, scriptable CLI with structured --json output for programmatic consumption.

• You do not own a Bluesound or NAD device — blu is specific to the BluOS ecosystem.
• You need a graphical interface or mobile-friendly controls; the official BluOS app is better suited for that.

Run blu devices to list all BluOS players on your network. Target a specific device via --device <id|name|alias>, the BLU_DEVICE environment variable, or a saved config default — whichever is most convenient for your workflow.

Issue blu play, blu pause, and blu stop commands to control playback on any targeted player. Check the current state at any time with blu --device <id> status.

Set the volume precisely with blu volume set <level>, making it easy to script scheduled volume changes or integrate volume control into automation routines.

Manage BluOS player groups with blu group status, blu group add, and blu group remove to build or tear down synchronized multi-room audio zones from the command line.

Search TuneIn stations with blu tunein search "query" and start playback instantly with blu tunein play "query", enabling radio automation without manual app interaction.

Pass --json to any command to receive structured JSON output, making blu easy to integrate into shell scripts, AI agent pipelines, and other automation tools.

Use a scheduled script to set volume to a comfortable level and start a TuneIn radio station across all grouped rooms every morning, without touching the BluOS app.

Quickly group multiple Bluesound players and start synchronized playback with a single shell command or AI agent instruction during a gathering.

Integrate blu into an AI agent workflow so a natural-language request like "pause the living room speaker" translates directly into a blu pause command targeting the correct device.

Poll blu --device <id> status --json in a monitoring script to track playback state across devices and trigger conditional actions based on what is currently playing.