blucli

• 您希望從腳本、shell 別名或 AI 代理自動化控制 Bluesound 或 NAD 播放器，而無需開啟 BluOS 應用程式。
• 您管理多房間音訊設置，需要透過腳本跨裝置進行分組、播放變更或音量調整。
• 您希望將 TuneIn 電台搜尋與播放整合至更廣泛的自動化工作流程中。
• 您偏好快速、可腳本化的 CLI，並搭配結構化的 --json 輸出以供程式化使用。

• 您沒有 Bluesound 或 NAD 裝置 — blu 專屬於 BluOS 生態系統。
• 您需要圖形介面或行動裝置友善的控制方式；官方 BluOS 應用程式更適合這種需求。

執行 blu devices 列出網路上所有 BluOS 播放器。透過 --device <id|name|alias> 參數、BLU_DEVICE 環境變數，或已儲存的設定預設值來指定特定裝置——選擇最適合您工作流程的方式即可。

發送 blu play、blu pause 和 blu stop 指令，以控制任何目標播放器的播放狀態。隨時使用 blu --device <id> status 查看目前狀態。

使用 blu volume set <level> 精確設定音量，輕鬆將排程音量變更編寫成腳本，或將音量控制整合至自動化流程中。

使用 blu group status、blu group add 和 blu group remove 管理 BluOS 播放器群組，從命令列建立或解散同步的多房間音訊區域。

使用 blu tunein search "query" 搜尋 TuneIn 電台，並透過 blu tunein play "query" 立即開始播放，無需手動操作應用程式即可實現電台自動化控制。

在任何指令後加上 --json，即可取得結構化的 JSON 輸出，讓 blu 輕鬆整合至 Shell 腳本、AI 代理流程及其他自動化工具中。

使用排程腳本，每天早晨自動將音量調整至舒適的水準，並在所有分組房間啟動 TuneIn 電台，無需開啟 BluOS 應用程式。

只需一個 shell 指令或 AI 代理指示，即可在聚會時快速將多台 Bluesound 播放器分組，並開始同步播放。

將 blu 整合至 AI 代理人工作流程中，讓「暫停客廳喇叭」這類自然語言請求，能直接轉換為針對正確裝置執行的 blu pause 指令。

在監控腳本中輪詢 blu --device <id> status --json，以追蹤各裝置的播放狀態，並根據目前正在播放的內容觸發條件式動作。