blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

⭐3.1kstars🔀474forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill integrates the BluOS CLI (blucli) to provide comprehensive control over Bluesound and NAD audio players. It enables seamless device discovery, playback management, volume adjustment, and multi-room grouping, bridging the gap between command-line efficiency and high-fidelity audio systems. Ideal for users looking to automate their smart home audio environment or manage devices without a GUI.

Use Cases

  • Smart Home Audio Automation: Incorporate audio playback and volume control into automated scripts or routines for home and office environments.
  • Multi-Device Grouping: Manage complex multi-room audio setups by grouping or ungrouping players and monitoring their status via the CLI.
  • Hands-free Media Control: Control playback, pause, and stop functions or search and play TuneIn radio stations directly through the agent interface.
  • Network Device Diagnostics: Discover all BluOS-enabled devices on a local network and retrieve detailed status information for troubleshooting or system monitoring.
nameblucli
descriptionBluOS CLI (blu) for discovery, playback, grouping, and volume.
homepagehttps://blucli.sh
metadata{"clawdbot":{"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> status
  • blu play|pause|stop
  • blu 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.