Skip to content

About

keylightctl is a CLI tool for managing your Elgato Key Light Air

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

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 ~/.config/keylightctl/config.json (respects $XDG_CONFIG_HOME; override with -config):

{
  "lights": [
    { "name": "Left", "ip": "192.168.2.164:9123" },
    { "name": "Right", "ip": "192.168.2.165:9123" }
  ]
}
keylightctl status           # show each light's status
keylightctl on               # turn on (-b brightness, -t temperature, -l light)
keylightctl off              # turn off (-l light)
keylightctl help             # print usage
keylightctl version          # print version

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

build.sh builds into build/.

./build.sh                  # debug, build/keylightctl
./build.sh release          # optimized and stripped
./build/keylightctl version    # run what you built
./build.sh test

Needs: Go from .tool-versions.

Install

./build.sh release
cp build/keylightctl ~/.local/bin/

~/.local/bin needs to be on your PATH. To uninstall, delete the binary.

About

keylightctl is a CLI tool for managing your Elgato Key Light Air

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages