openhue

name	openhue
description	Control Philips Hue lights, scenes, rooms via OpenHue CLI.
version	1.0.0
author	community
license	MIT
platforms	["linux","macos","windows"]
metadata	{"ion":{"tags":["Smart-Home","Hue","Lights","IoT","Automation"],"homepage":"https://www.openhue.io/cli"}}
prerequisites	{"commands":["openhue"]}

OpenHue CLI

Manage Philips Hue lights and scenes through a Hue Bridge from the command line.

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

The first time you run it, you'll need to press the button on your Hue Bridge to complete pairing. 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

• The bridge must be on the same local network as the machine running Ion
• Initial setup requires physically pressing the button on the Hue Bridge for authorization
• Color settings only apply to color-capable bulbs (white-only models ignore them)
• Light and room names are case-sensitive — run openhue get light to verify exact names
• Works well with cron jobs for scheduled lighting (e.g. dim at bedtime, bright at wake)