keylightctl

command module
v0.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 3, 2026 License: MIT Imports: 1 Imported by: 0

README

keylightctl

Controls Elgato Key Light Air devices from the terminal: get status, turn lights on and off, and set brightness and temperature, either with subcommands or in a full-screen interactive TUI.

Lights are read from $HOME/.keylightctl.toml (override with --config):

[[lights]]
name = "Left"
ip = "192.168.2.164:9123"

[[lights]]
name = "Right"
ip = "192.168.2.165:9123"
keylightctl status      # show each light's status
keylightctl on          # turn on (--brightness, --temperature, --light)
keylightctl off         # turn off (--light)
keylightctl --help      # full command list

Run keylightctl with no arguments for the interactive TUI:

Key Action
h / l Move between lights
j / k Move between brightness / temp
= / - Adjust focused property
enter Toggle the selected light
a Toggle all lights
r Refresh status
q, esc, ctrl+c Quit

TUI screenshot

Build and install with make:

make build        # ./keylightctl
make install      # to ~/.local/bin (override with BINDIR=)
make uninstall    # remove from BINDIR

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
internal

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL