OpenHue CLI
使用 openhue 透過 Hue Bridge 控制 Philips Hue 燈泡與場景。
使用時機
請在以下情況使用:
- 「開/關燈」
- 「調暗客廳燈光」
- 「設定場景」或「電影模式」
- 控制特定的 Hue 房間或區域
- 調整亮度、顏色或色溫
不應使用的情況
請勿在以下情況使用:
- 非 Hue 的智慧裝置(其他品牌)-> 不支援
- HomeKit 場景或捷徑 -> 請使用 Apple 的「家庭」App 或「捷徑」
- 電視或娛樂系統控制
- 恆溫器或 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 微倒度)
openhue set light "Bedroom Lamp" --on --temperature 300
# 顏色(依名稱或十六進位碼)
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
備註
- Hue Bridge 必須位於本地網路中
- 首次執行需按下 Hue Bridge 上的按鈕以進行配對
- 顏色功能僅支援具備彩色能力的燈泡(不適用於純白光燈泡)