v2.7 — fewer actions, more control

Your Govee lights,
without the phone.

One press for a saved scene. One rotation for the perfect setting. Five hybrid actions work on both Stream Deck keys and Stream Deck+ dials — so you stop reaching for your phone every time you start a meeting, stream, or movie.

Install on Stream Deck Source on GitHub →
On/Off
Brightness
Color
Color Temperature
Segments
Brightness
75%
Color
210°
Temp
4500K
Segment 3
120°
What's inside · v2.7

One action. Key or dial.
Done.

Five hybrid actions cover everything you'd reach for, plus a new Recall composite that turns any saved look into a single press. Replaces 17 atomic actions from earlier versions.

New in v2.7 · Headline

Recall — one key, any saved look

Pick from every Govee dynamic scene, your DIY moods, and saved snapshots — in a single dropdown. Drop the action on a key, choose "Sunset" or "Movie night" or "Late-night code" — press to apply. Replaces juggling separate Scene and Snapshot keys for the same job.

Five hybrid actions — same UUID on a key or a Stream Deck+ dial

On / Off

Toggle a light or a whole group. Three-state title (●/◐/○) with N/M count for groups — never lies about mixed state.

Brightness

Press for a fixed %. Or drop the same action on a Stream Deck+ dial: rotate to adjust, press to toggle power.

Color

Press for a fixed RGB pick. Or rotate the dial through the full hue wheel with live colour feedback on the LCD.

Color Temperature

Press for a fixed Kelvin. Rotate the dial between 2000K warm candlelight and 9000K crisp daylight.

Segment Color

For RGB IC strips: press for rainbow / solid / gradient presets across a range. Or rotate to tune one segment at a time.

Saturation

Press for a fixed %. Rotate to dial from grey to vivid on the LCD. Same hybrid pattern as the rest.

Plus the tools you reach for

Scene · Snapshot · Music Mode

Apply Govee dynamic scenes, recall saved presets, or trigger audio-reactive lighting with adjustable sensitivity.

Feature Toggle

Nightlight, Gradient, DreamView, Scene Stage — auto-filtered by what each device actually supports.

Schedule · Sequence · Custom Effect

Daily / weekly / delayed automation. Chain commands with delays. Animated RGB effects on IC strips.

Built to tell the truth

Group state that finally matches reality

●
All on · 2/2
Solid glyph + N/M count when every member is on.
◐
Mixed · 1/2
Half glyph + count. No more silent lies about uniform state.
○
All off · 0/2
Empty glyph + desaturated multi-state icon variant.
⚠
2/3 failed
Persists 30s when partial group apply fails — never silent.
How it works

Set up in under a minute

No accounts to create, no servers, no configuration files. Just paste an API key and go.

Install the plugin

Download from the Elgato Marketplace. The plugin appears instantly in your Stream Deck app.

Get your Govee API key

Open the Govee app, tap your profile, request a free developer API key. Usually arrives in under a minute by email — no approval needed.

Drag and configure

Drop an action on a key or a Stream Deck+ dial — same action, same settings. Press for a fixed value, rotate to adjust.

Common questions

Before you install

Do I need a Stream Deck+?

No. The five hybrid actions work on any Stream Deck — keys behave as fixed-value presses. A Stream Deck+ unlocks the rotate-to-adjust experience on the dial half. Same action either way.

Where does my Govee API key live?

In Stream Deck's encrypted local settings store on your machine. Never sent anywhere except the Govee Cloud API itself. No analytics endpoint. No telemetry. The full source is on GitHub if you want to verify.

Will my v2.6 setup break when I install v2.7?

No. The five legacy *-Dial UUIDs stay registered as (legacy) entries with their original behaviour. Existing key bindings keep working. Re-binding to the unified hybrid actions is optional.

What happens when Govee changes the API?

Plugin uses a versioned API client (@felixgeelhaar/govee-api-client) with circuit-breaker, retry, and rate-limit guards. When Govee changes, the client gets patched and the plugin picks it up on the next release. Open issues track API drift.

Does it work with Govee app groups?

Govee Cloud groups (SameModelGroup, BaseGroup) appear in the device dropdown as a disabled hint — Govee's API doesn't accept commands on them. Use the plugin's own group manager to compose multiple lights into a group you can drive together.

What if a group apply only half-works?

The key shows ⚠ N/M failed for 30 seconds — never a silent green checkmark. State sync also reverts the optimistic update if every member failed.

Ready to light up your setup?

Free, open source, and built to stay out of your way.

Get on Marketplace Star on GitHub