Skip to main content

keylightd

A daemon for discovering, monitoring, and controlling Elgato Key Light devices. CLI, HTTP API, Unix socket, system tray, and GNOME extension included.

terminal
$keylightctl light list
Key Light Left   80% @ 4500K   ON
Key Light Right   65% @ 5000K   ON
$keylightctl group set office brightness 100
OK

Control Your Lights, Your Way

💡

Auto-Discovery

Automatically finds Elgato Key Lights on your network via mDNS/Bonjour. No manual IP configuration needed.

⌨️

CLI Control

Full control from the command line with keylightctl. Interactive mode, parseable output, and waybar integration.

🌐

REST API

HTTP API with OpenAPI spec, Bearer token auth, multi-group operations, and real-time WebSocket events.

🔌

Unix Socket

Low-latency local control via Unix socket. No auth overhead for same-user processes and scripts.

🖥️

Desktop Apps

System tray app with CSS theming, GNOME extension, and Waybar module for desktop integration.

👥

Group Management

Organize lights into groups for batch control. Set brightness, temperature, and power for all lights at once.

Quick Install (Arch Linux)

$ paru -S keylightd-bin

Also available via Homebrew, binary releases, and source builds