Govee
@keeb/goveev2026.06.11.1
01README
Control Govee lights over the local LAN API (UDP) from swamp workflows — discover devices, turn them on/off, toggle, and set brightness, RGB color, and white color temperature.
02Models
@keeb/goveev2026.06.11.1govee.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| host | string | IP address of the Govee device |
| brightness? | number | Default brightness applied when turning on (1–100). Omit to leave brightness unchanged. |
| colorTemInKelvin? | number | Default white color temperature in Kelvin applied when turning on (2000 = warm, 9000 = cool). Omit to leave color unchanged. |
fn find(subnet?: string, timeoutMs: number)
Scan the local network for Govee devices with LAN Control enabled. Defaults to the /24 subnet of the configured host.
| Argument | Type | Description |
|---|---|---|
| subnet? | string | CIDR subnet to scan, e.g. 10.0.0.0/24. Defaults to /24 of the configured host. |
| timeoutMs | number | How long to listen for scan replies in milliseconds (default: 3000) |
fn sync()
Read current light state and device info from the device
fn on()
Turn the Govee light on. If brightness or colorTemInKelvin are set in the model's global args, they are applied at the same time.
fn off()
Turn the Govee light off
fn toggle()
Toggle the Govee light on or off
fn glitch(seconds: number, frameMs: number, brightness: number)
Play the Swamp Club animation (cyan and pink alternating in 5s blocks), then restore the previous light state.
| Argument | Type | Description |
|---|---|---|
| seconds | number | How long to run the animation; 0 runs forever until the process is killed (default: 30) |
| frameMs | number | Frame interval in milliseconds, matching the landing page's 250ms tick (default: 250) |
| brightness | number | Brightness during the animation (default: 100) |
fn purple(brightness: number)
Purple mode: turn on and set the signature purple (#8B00FF, RGB 139,0,255) at the given brightness.
| Argument | Type | Description |
|---|---|---|
| brightness | number | Brightness percentage (default: 74) |
fn set(brightness?: number, colorTemInKelvin?: number, on?: boolean)
Set brightness (1–100), RGB color, white color temperature in Kelvin, and/or power state. Color and colorTemInKelvin are mutually exclusive. At least one argument is required.
| Argument | Type | Description |
|---|---|---|
| brightness? | number | Brightness percentage (1–100) |
| colorTemInKelvin? | number | White color temperature in Kelvin (2000 = warm, 9000 = cool). Mutually exclusive with color. |
| on? | boolean | Turn the light on or off |
Resources
state(infinite)— Current light state (on/off, brightness, color)
info(infinite)— Static device information (device ID, SKU, firmware)
found(7d)— Results of the most recent LAN scan for Govee devices
03Stats
Downloads
0
Archive size
16.8 KB
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
Repository
https://github.com/keeb/keylight04Platforms