blucli
steipete/clawdis
Control Bluesound/NAD players via CLI for discovery, playback, grouping, and volume.
What is blucli?
BluOS CLI (blu) is a command-line tool for managing Bluesound and NAD audio players. Use it to discover devices, control playback, manage speaker groups, adjust volume, and search/play TuneIn streams.
- Discover and list connected Bluesound/NAD devices
- Control playback (play, pause, stop) on target devices
- Manage speaker grouping (add/remove devices from groups)
- Adjust volume levels on individual or grouped players
- Search and play TuneIn radio streams
- Output results as JSON for scripting and automation
How to install blucli
npx skills add https://github.com/steipete/clawdis --skill blucli- Go installed (for building from source)
- At least one Bluesound or NAD player on the network
How to use blucli
- 1.Run `blu devices` to discover and list all available Bluesound/NAD players
- 2.Identify your target device ID or name from the list
- 3.Set target device using `--device <id|name|alias>` flag, `BLU_DEVICE` environment variable, or configure a default in config
- 4.Use `blu --device <id> status` to check device status
- 5.Control playback with `blu play`, `blu pause`, or `blu stop`
- 6.Adjust volume with `blu volume set <level>`
- 7.For scripts, append `--json` flag to get structured output
Use cases
- Automate multi-room audio playback across grouped speakers
- Build custom scripts to control audio devices from CI/CD pipelines
- Query device status and integrate with home automation systems
- Create voice assistant integrations for audio control
- Manage TuneIn radio playback programmatically
- Home automation enthusiasts
- DevOps engineers building audio control systems
- Developers integrating Bluesound/NAD devices into applications
- System administrators managing multi-room audio setups
blucli FAQ
Use `--device <id|name|alias>` flag, set the `BLU_DEVICE` environment variable, or configure a default device in your config file. The CLI checks these in priority order.
Yes, use `blu group add` to add devices to a group, then control the group as a single unit.
Use `blu tunein search "query"` to find stations, then `blu tunein play "query"` to start playback.
Yes, append `--json` to any command when building scripts or integrations to get structured, parseable output.
Always confirm the target device before changing playback. Use `blu --device <id> status` to verify you're controlling the correct player.
Full instructions (SKILL.md)
Source of truth, from steipete/clawdis.
name: blucli description: "BluOS CLI (blu) for discovery, playback, grouping, and volume." homepage: https://blucli.sh metadata: { "openclaw": { "emoji": "🫐", "requires": { "bins": ["blu"] }, "install": [ { "id": "go", "kind": "go", "module": "github.com/steipete/blucli/cmd/blu@latest", "bins": ["blu"], "label": "Install blucli (go)", }, ], }, }
blucli (blu)
Use blu to control Bluesound/NAD players.
Quick start
blu devices(pick target)blu --device <id> statusblu play|pause|stopblu volume set 15
Target selection (in priority order)
--device <id|name|alias>BLU_DEVICE- config default (if set)
Common tasks
- Grouping:
blu group status|add|remove - TuneIn search/play:
blu tunein search "query",blu tunein play "query"
Prefer --json for scripts. Confirm the target device before changing playback.
Related skills
More from steipete/clawdis and the wider catalog.
bluebubbles
Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.
camsnap
Capture frames and clips from RTSP/ONVIF cameras via command line.
clawhub
Search, install, and manage AI agent skills from ClawHub registry.
coding-agent
Delegate coding work to background agents (Claude Code, Codex, OpenCode) for large refactors and feature builds.
discord
Send, read, edit, delete, react, poll, pin, and search Discord messages with components and media support.
eightctl
Control Eight Sleep pods via CLI—check status, adjust temperature, manage alarms and schedules.