Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help


title: “Openhue — Control Philips Hue lights, scenes, rooms via OpenHue CLI” sidebar_label: “Openhue” description: “Control Philips Hue lights, scenes, rooms via OpenHue CLI”

{/* This page is auto-generated from the skill’s SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Openhue

Control Philips Hue lights, scenes, rooms via OpenHue CLI.

Skill metadata

SourceBundled (installed by default)
Pathskills/smart-home/openhue
Version1.0.0
Authorcommunity
LicenseMIT
Platformslinux, macos, windows
TagsSmart-Home, Hue, Lights, IoT, Automation

Reference: full SKILL.md

:::info The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
::

OpenHue CLI

Control Philips Hue lights and scenes via a Hue Bridge from the terminal.

Prerequisites

# Linux (pre-built binary)
curl -sL https://github.com/openhue/openhue-cli/releases/latest/download/openhue-linux-amd64 -o ~/.local/bin/openhue && chmod +x ~/.local/bin/openhue

# macOS
brew install openhue/cli/openhue-cli

First run requires pressing the button on your Hue Bridge to pair. The bridge must be on the same local network.

When to Use

  • “Turn on/off the lights”
  • “Dim the living room lights”
  • “Set a scene” or “movie mode”
  • Controlling specific Hue rooms, zones, or individual bulbs
  • Adjusting brightness, color, or color temperature

Common Commands

List Resources

openhue get light       # List all lights
openhue get room        # List all rooms
openhue get scene       # List all scenes

Control Lights

# Turn on/off
openhue set light "Bedroom Lamp" --on
openhue set light "Bedroom Lamp" --off

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

# Color temperature (warm to cool: 153-500 mirek)
openhue set light "Bedroom Lamp" --on --temperature 300

# Color (by name or hex)
openhue set light "Bedroom Lamp" --on --color red
openhue set light "Bedroom Lamp" --on --rgb "#FF5500"

Control Rooms

# Turn off entire room
openhue set room "Bedroom" --off

# Set room brightness
openhue set room "Bedroom" --on --brightness 30

Scenes

openhue set scene "Relax" --room "Bedroom"
openhue set scene "Concentrate" --room "Office"

Quick Presets

# Bedtime (dim warm)
openhue set room "Bedroom" --on --brightness 20 --temperature 450

# Work mode (bright cool)
openhue set room "Office" --on --brightness 100 --temperature 250

# Movie mode (dim)
openhue set room "Living Room" --on --brightness 10

# Everything off
openhue set room "Bedroom" --off
openhue set room "Office" --off
openhue set room "Living Room" --off

Notes

  • Bridge must be on the same local network as the machine running Hermes
  • First run requires physically pressing the button on the Hue Bridge to authorize
  • Colors only work on color-capable bulbs (not white-only models)
  • Light and room names are case-sensitive — use openhue get light to check exact names
  • Works great with cron jobs for scheduled lighting (e.g. dim at bedtime, bright at wake)