openhue

OpenHue CLI

使用 openhue 透過 Hue Bridge 控制 Philips Hue 燈具與情境。

適用時機

適用於以下情境：

• 「開燈/關燈」
• 「調暗客廳的燈」
• 「設定情境」或「開啟電影模式」
• 控制特定的 Hue 房間或區域
• 調整亮度、顏色或色溫

不適用時機

請勿用於以下情況：

• 非 Hue 智慧裝置（其他品牌）-> 不支援
• HomeKit 情境或「捷徑」（Shortcuts）-> 請使用 Apple 生態圈工具
• 控制電視或娛樂系統
• 恆溫器或空調系統（HVAC）
• 智慧插座（除非是 Hue 原廠智慧插座）

常見指令

列出資源

openhue get light       # 列出所有燈具
openhue get room        # 列出所有房間
openhue get scene       # 列出所有情境

控制燈具

# 開啟/關閉
openhue set light "Bedroom Lamp" --on
openhue set light "Bedroom Lamp" --off

# 亮度 (0-100)
openhue set light "Bedroom Lamp" --on --brightness 50

# 色溫 (暖色至冷色：153-500 mirek)
openhue set light "Bedroom Lamp" --on --temperature 300

# 顏色 (輸入名稱或 HEX 色碼)
openhue set light "Bedroom Lamp" --on --color red
openhue set light "Bedroom Lamp" --on --rgb "#FF5500"

控制房間

# 關閉整個房間的燈
openhue set room "Bedroom" --off

# 設定房間亮度
openhue set room "Bedroom" --on --brightness 30

情境模式

# 啟動情境
openhue set scene "Relax" --room "Bedroom"
openhue set scene "Concentrate" --room "Office"

快速預設值

# 就寢模式 (微暗暖光)
openhue set room "Bedroom" --on --brightness 20 --temperature 450

# 工作模式 (明亮冷光)
openhue set room "Office" --on --brightness 100 --temperature 250

# 電影模式 (微暗)
openhue set room "Living Room" --on --brightness 10

注意事項

• Bridge 必須位於區域網路內
• 首次執行時需按下 Hue Bridge 上的按鈕進行配對
• 顏色調整僅適用彩光燈泡（不支援純白光燈泡）