blucli

BluOS CLI (blu) 是一款專為 Bluesound 與 NAD 多房間音訊系統使用者設計的專業自動化工具。它提供了一個直接且可腳本化的介面來與聯網的音訊播放器進行互動，彌補了硬體控制與終端工作流程之間的差距。無論您是要自動化家庭音訊環境、管理多房間同步，還是將音訊狀態整合到您的個人 AI 助理儀表板中，此工具都能提供精細控制所需的介面。它主要針對電力使用者、家庭自動化愛好者以及需要程式化存取音訊播放狀態（無需依賴專有行動應用程式）的開發人員。

• 完整控制播放狀態，包括播放、暫停、停止與跳過功能。

• 進階多房間群組功能：動態新增或移除群組中的播放器，並檢查當前的群組狀態。

• 使用自訂識別碼、別名或環境變數（如 BLU_DEVICE）進行即時設備發現與選擇。

• 直接存取如 TuneIn 等串流服務，允許使用者透過 CLI 搜尋並啟動廣播電台或媒體內容的播放。

• 支援特定音量等級設定。

• 支援 JSON 輸出，專為整合到 Shell 腳本、自動化管線與 AI 代理工具集而設計。

• 請確保所有目標播放器與主機位於同一個區域網路內，以確保設備發現順利。

• 請使用 --json 參數以進行自動化解析與設備狀態報告的程式化使用。

• 在執行播放變更之前，務必使用 devices 命令確認當前的目標設備，以避免誤觸未預期的設備。

• 此工具在設定為個人 AI 助理的動作或技能時特別有效，可實現語音控制或情境感知的音訊管理。

• 需要穩定的網路環境；請確保防火牆設定允許與 BluOS 發現通訊埠進行通訊。

• 非常適合在智慧家庭環境中建立自動化常規，例如「早晨音樂」觸發器或「全數停止」關機指令。