A high-performance command line interface for discovering, controlling, and grouping Bluesound and NAD audio players.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install luke-blucli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install luke-blucli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is blucli (blu)?
blucli (blu) is a specialized tool designed for power users and developers who need programmatic or terminal-based control over BluOS-enabled hardware. By integrating this capability into Openclaw Skills, users can bridge the gap between their development environment and their physical audio workspace, enabling seamless control over device playback, grouping, and volume levels without leaving the command line.
The utility excels at handling multi-room audio environments, offering robust device discovery and a predictable interface for interacting with the BluOS API. It is an essential component for those looking to build sophisticated automation workflows or simple desktop shortcuts for their premium audio hardware.
blucli (blu) Use Cases
- Automating audio playback transitions during deep work sessions using Openclaw Skills scripts.
- Managing multi-room audio groups (add/remove players) directly from the terminal.
- Integrating Bluesound volume control into system-level keyboard shortcuts or macros.
- Searching and triggering TuneIn radio stations through automated CLI commands.
- Monitoring player status and metadata for custom dashboard integrations.
How blucli (blu) Works
- Discovery: The tool scans the local network to identify available Bluesound or NAD devices.
- Target Selection: The user specifies a target player via the --device flag, the BLU_DEVICE environment variable, or a pre-configured default.
- Command Execution: blucli sends structured requests to the BluOS API based on the subcommand (e.g., play, pause, volume).
- Data Processing: For scripts, the utility returns response data in JSON format to ensure interoperability with other Openclaw Skills.
- State Management: The tool tracks group status and playback state to confirm successful command execution.
blucli (blu) Setup
To install blucli and integrate it with your Openclaw Skills environment, ensure you have Go installed and run:
go install github.com/steipete/blucli/cmd/blu@latest
Verify the installation by listing available devices:
blu devices
You can set a default device to simplify commands:
export BLU_DEVICE="Your_Player_Name"
blucli (blu) Data Schema & Taxonomy
The skill utilizes a structured approach to device management and output. When using the --json flag, the data is organized as follows:
| Attribute | Description |
|---|---|
id |
Unique identifier for the BluOS hardware. |
name |
Human-readable alias of the player. |
status |
Current playback state (Playing, Paused, Stopped). |
volume |
Integer value representing the current decibel level. |
group |
Metadata regarding linked players and master/follower roles. |
blucli (blu) Advanced Features
- JSON Output Mode: Use the --json flag for seamless integration with downstream data processors in Openclaw Skills.
- Advanced Grouping: Granular control over multi-device synchronization using the group status, add, and remove subcommands.
- Flexible Targeting: Support for device ID, name, or alias to ensure scripts remain portable across different network environments.
- TuneIn Integration: Deep-link search and playback functionality for rapid access to global radio streams.
SKILL.md
Loading
Related Openclaw Skills
Skill Discovery & Installation
A specialized skill designed to browse, discover, and instantly install new capabilities from the open agent skills ecosystem.
DaE Persona Context Injector
A specialized upstream profiling skill that builds high-fidelity, reusable persona profiles to eliminate generic AI responses and improve downstream agent collaboration.
Loop Engine Governance
A policy enforcement layer for Openclaw Skills that routes agent decisions through human-in-the-loop approvals and runtime guards.
FreeRide
FreeRide automates the selection and configuration of high-quality free AI models from OpenRouter for the OpenClaw ecosystem.
Bookkeeping AI Assistant
An automated personal finance manager that tracks income, expenses, and savings goals using local JSON storage.
Strategic Analyst
A professional-grade strategic intelligence agent for industry analysis, market opportunity assessment, and data-driven investment recommendations.
Featured*
