elgato-lights-connection

Elgato Key Light Connection

Control your Elgato Key Lights on Windows using buttons on the Logitech MX Creative Console via Logi Options+.

Note: You can use these scripts to control your lights from any hardware or software, but the setup below assumes the MX Creative Console!

Requirements

• Windows 10/11
• Python 3.6+
• Logi Options+ (if you're controlling the app from the MX Creative Console)
• Elgato Key Light(s) on the same local network (this has been tested with the original Elgato Key Light and the Elgato Key Light Air)

(This also assumes you have the MX Creative Console device)

Installation

git clone <repository-url>
cd elgato-lights-mx-connection
pip install -r requirements.txt

Setup

In the Elgato Control Center, select your light and note its IP address under its Accessory Settings.

Run the interactive wizard once per light:

python setup_light.py

The wizard will:

1. Ask for the light's IP address and verify the connection
2. Save a config file to config/
3. Optionally generate .bat + .vbs wrapper files in batch/

Tip: To find your light's IP, open Elgato Control Center → select your light → Settings → Network.

Binding to Logi Options+

The wizard generates two files per action in the batch/ folder:

In Logi Options+, point each button to the .vbs file — not the .bat. This runs the script completely in the background with no console window appearing.

To point the button to the script, in Logi Options+:

1. Select the button you want to configure.
2. Choose "System Actions" and then "Open File"
3. Browse to the .vbs file generated by the setup wizard in the batch/ folder.

You can stop here! Below is some extra documentation for advanced usage.

You can open the .bat or .vbs files in whatever software you want, and it will call the functions you set up.

python toggle_light.py 192.168.1.100
python turn_on_light.py 192.168.1.100
python turn_off_light.py 192.168.1.100
python set_brightness.py 192.168.1.100 75       # 0–100
python set_color_temp.py 192.168.1.100 4000     # 2700–7000K
python set_color.py 192.168.1.100 255 0 0       # R G B (0–255)

{
	"name": "Desk Light",
	"ip_address": "192.168.1.100",
	"port": 9123,
	"description": "Main desk key light"
}

python -m pytest tests\

from scripts.light_controller import LightController

light = LightController("192.168.1.100")
light.turn_on()
light.set_brightness(80)
light.set_color_temperature(4000)

Resources

• Elgato Key Light
• Logi Options+