> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brewbot.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Light Effects

> Control Govee lights and switch to a lighting scene when viewers send TikTok gifts.

> [!NOTE]
>
> This is a **premium feature**. [Upgrade your plan](https://docs.brewbot.gg/getting-started/billing.md) to access it.

Light Effects lets you control your Govee lights from the dashboard and change them to a scene when a viewer sends a TikTok gift. For example, Rose could switch your desk light to Rainbow at full brightness for 15 seconds, then back to a dim orange. Light Effects is in **beta**. Which lights and scenes you can use depends on your Govee model.

Open **Live Tools > Light Effects**. You need access to the server and premium live tools. It works on personal and team servers; on team servers, members need [Speed Dating access](https://docs.brewbot.gg/getting-started/teams.md#feature-permissions) to open the page.

Personal server owners, team admins, and designated server admins can control lights and edit gift effects. Other members with access see your lights, settings, and gift effects as view only.

The strip at the top of the page shows whether gift automation is on and for which account, how many lights and gift effects you have, and how many Govee requests BrewBot has sent today.

![Status strip: gift automation on for @streamer, 2 lights with 1 resting look, 2 gift effects on, and 214 of 9,999 Govee requests used today](https://mintcdn.com/brewbot/tGkwA6l-pZMR714-/images/light-effects/overview-light.png?fit=max\&auto=format\&n=tGkwA6l-pZMR714-\&q=85\&s=e053d564f157d4722a98ed87db53adcb)

## Before you start

1. Connect your Govee account in [Govee Cloud](https://docs.brewbot.gg/integrations/govee.md).
2. Add the TikTok account you stream from in [TikTok Chat Monitor](https://docs.brewbot.gg/features/live-monitor.md), and make sure monitoring is turned on.

Only lights that Govee's cloud API supports show up. If a light is missing, add it in Govee Home, then select **Refresh devices** on this page.

## Control your lights

**Your lights** lists your Govee lights. Select **Turn on** or **Turn off** to switch a light. Lights that don't support power control from Govee's cloud have these buttons turned off.

With more than six lights, the list shows the first five. Select **Show all** followed by the number of lights to see the rest, and **Show fewer lights** to collapse it again.

Power commands don't change your gift effects. A success message means Govee accepted the command. The light itself may take a moment to respond. Turning a light on or off also cancels a pending switch-back on that light.

![Your lights panel with the resting look editor open for Desk light: solid orange color at 30% brightness](https://mintcdn.com/brewbot/9-LTKSKmwIbXyCVe/images/light-effects/your-lights-light.png?fit=max\&auto=format\&n=9-LTKSKmwIbXyCVe\&q=85\&s=6c18c0e99e7ff0d09c7bf96d1b2aee8a)

## Set a resting look

A resting look is what a light switches back to after a timed gift scene. It belongs to the light, not to a gift: set it once, and every gift effect on that light with a scene length switches back to it. You need one before you can give a gift effect a scene length.

1. In **Your lights**, select **Resting look** next to the light.
2. Choose a **Resting look**: a **Scene** or a **Solid color**. Choose **No scene or color** to only change the brightness.
3. Optionally choose a **Brightness**.
4. Select **Save resting look**.

Each light's row shows its resting look, for example **Resting: #FF8800 · 30%**. To remove one, open **Resting look**, choose **No scene or color** with brightness **Don't change**, then select **Clear resting look**.

> [!NOTE]
>
> BrewBot switches back to the resting look you set, not to whatever the light was showing before the gift. Govee doesn't report which scene a light is running, so BrewBot can't restore it.

### Set one resting look for all your lights

With two or more lights, you don't have to set each one separately. **Set for all lights** saves the same resting look to every light you check.

1. In **Your lights**, select **Set for all lights**.
2. Choose a **Resting look** and, optionally, a **Brightness**, the same way as for one light. The form starts on **Scene**.
3. Under **Apply to**, every light starts checked. Uncheck any light that should keep its own resting look, or use **Uncheck all** and pick a few.
4. Select **Save for** followed by the number of lights.

The resting look replaces the current one on every checked light. Unchecked lights keep theirs, and you can still change any single light afterwards with its own **Resting look** button. To clear many at once, choose **No scene or color** with brightness **Don't change**.

Lights that can't show the look you chose are greyed out and skipped:

* **Solid color** skips lights without color support. Lights without brightness control get the color only.
* **Scene** is picked by name across all your lights. Each Govee model has its own scenes, so every light switches back to its own model's version of that scene. The menu shows how many checked lights have each scene, for example **Built-in · Sunrise (18 of 22 lights)**, and lights without it are greyed out as **No Sunrise scene**.
* **No scene or color** with a brightness skips lights without brightness control.

With only one light, **Set for all lights** doesn't appear. Use the light's **Resting look** button.

> [!NOTE]
>
> Saving a scene for many lights checks it on each light with Govee, which uses one or two of your daily Govee requests per light. Colors and brightness don't need this check.

## Connect a gift to a scene

1. In **Connect a gift to a scene**, choose a **TikTok gift**.
2. Choose a **Light**: one light, **All lights**, or **Choose lights…** to check the ones you want. Only lights that support scenes are listed.
3. Choose a **Scene**. Built-in scenes come from Govee; DIY scenes are ones you made in Govee Home.
4. Optionally choose a **Brightness** for the scene. **Don't change** keeps the light's current brightness.
5. Choose a **Scene length**: **Until something else changes it**, or 5 to 120 seconds followed by the light's resting look.
6. Select **Save gift effect**.

Each gift has one scene. Saving a gift again replaces its scene and lights.

![Connect a gift to a scene form: Rose on Desk light with the Rainbow scene at 100% brightness for 15 seconds, then the light's resting look](https://mintcdn.com/brewbot/9-LTKSKmwIbXyCVe/images/light-effects/gift-scene-light.png?fit=max\&auto=format\&n=9-LTKSKmwIbXyCVe\&q=85\&s=4f14b758d28b320fefdf3396a39c7196)

> [!TIP]
>
> To use your own animation, create a DIY scene in Govee Home, then select **Refresh devices** so it appears in the **Scene** menu.

### Play a gift on all your lights

Set a gift once and every light can play it. Choose **All lights** under **Light**, or **Choose lights…** and check the lights you want. With one light, these choices don't appear.

Each Govee model has its own scenes, so with several lights you pick a scene by name. Every light plays its own model's version of that scene. The **Scene** menu shows how many of your lights have each scene, for example **Built-in · Rainbow (18 of 33 lights)**. Lights that don't have the scene are skipped, and the form lists them before you save. The gift still plays on the rest.

With several lights:

* A **Brightness** applies to every light that can dim. Lights without brightness control just play the scene.
* A **Scene length** needs a resting look on every light. If some are missing, the form names them. Use **Set for all lights** in **Your lights** to give them one at once.
* The lights change together. BrewBot sends to up to 10 lights at a time, and they switch back to their resting looks together too.

> [!WARNING]
>
> Every light counts toward Govee's daily limit (see below). A gift on 33 lights with a brightness uses 66 requests, and 99 to 132 with a scene length, depending on the resting looks. The form shows how many requests each gift uses and roughly how many such gifts the limit covers in a day. Gifts on many lights during a busy stream can use up the day's requests.

## Turn on gift automation

1. In **Gift automation**, choose the **TikTok account** to listen to.
2. Turn on **Enable gift effects**.

Both the main switch and the switch for each gift effect must be on. Gift effects run separately from overlays and [Gift Sounds](https://docs.brewbot.gg/features/gift-sounds.md), so they work even without OBS.

Changing the TikTok account pauses automation. Turn **Enable gift effects** back on after choosing the new account. After you turn automation on, it can take up to 15 seconds before gifts start changing your lights.

![Gift automation panel with gift effects on for @streamer](https://mintcdn.com/brewbot/tGkwA6l-pZMR714-/images/light-effects/automation-light.png?fit=max\&auto=format\&n=tGkwA6l-pZMR714-\&q=85\&s=e95478c4363bac09dbff9f184a3a6470)

## How gifts trigger scenes

* Each gift triggers its scene once. A gift streak triggers once, when the streak finishes, no matter how many gifts were in it.
* Gifts sent to a co-host or guest instead of the host are skipped.
* The same gift can trigger at most once every 5 seconds.
* Your lights take at most one command per second, and that limit is shared with the dashboard's power and test buttons. Gifts that arrive while your lights are busy are skipped, not queued.
* A scene with a brightness sends two commands to each light: the scene, then the brightness.
* A gift on several lights sends to up to 10 lights at once, so lights stay busy one second per command for every 10 lights. For example, 33 lights with a brightness are busy for 8 seconds. If one light doesn't respond, the others still change, and the gift effect names the lights that failed.
* With a scene length, the light switches back to its resting look when the time is up. If another gift changes the same light first, the timer restarts from that gift. A gift without a scene length, or a manual **Turn on** or **Turn off**, cancels the switch-back.
* Switching back still happens if BrewBot restarts during your stream. If your lights are busy at that moment, it waits a second instead of being skipped.
* Without a scene length, a scene stays on until something else changes the light.
* Failed gift commands aren't retried, because Govee may already have applied them. A failed switch-back is tried up to three times in total before a warning appears on the light.

## Govee's daily limit

Govee allows 10,000 requests per account each day. To stay under it, BrewBot counts every request it sends with your key, including loading lights and scenes, tests, gifts, and switch-backs, and stops at 9,999 until midnight UTC.

The **Govee requests today** tile at the top of the page tracks the count with a bar. It turns amber at 80% and shows how many requests are left. At 9,999 it turns red and shows **Paused until midnight UTC**.

* Each light a gift plays on uses its own requests. **Gift effects** shows how many requests each gift uses.
* A timed gift only runs if its switch-back also fits under the limit, so a light is never left on a gift scene because the limit ran out.
* Servers that use the same Govee key share one count.
* Other apps that use your key also count toward Govee's limit, but BrewBot can't see them. If you use the key elsewhere, Govee may still limit you before BrewBot's count reaches 9,999.

## Test, edit, pause, or remove a gift effect

Each saved effect in **Gift effects** shows the light (or how many lights; select it to see their names), the scene, its brightness and scene length, how many Govee requests one gift uses, and the last time a gift tried to trigger it.

![Gift effects list: Rose switches Desk light to Rainbow at 100% for 15 seconds; Galaxy sets Shelf strip to Gift celebration until something else changes it](https://mintcdn.com/brewbot/9-LTKSKmwIbXyCVe/images/light-effects/gift-effects-light.png?fit=max\&auto=format\&n=9-LTKSKmwIbXyCVe\&q=85\&s=c7cd38e02e75bb624479cea7bcf77e50)

| Action | What it does |
| - | - |
| Switch | Turns that gift effect on or off without deleting it. |
| **Test scene** | Sends the scene and brightness to your real lights now, even if gift automation is paused. If the effect has a scene length, the lights switch back afterwards, just like a real gift. A successful test clears the effect's last error. |
| **Edit** | Opens the gift effect in the form on the right with its lights, scene, brightness, and scene length filled in. The gift stays the same; to use another gift, save a new effect. Select **Save changes** to replace the effect, or **Cancel** to keep it. |
| **Remove** | Deletes the gift effect. |

## Troubleshooting

| Symptom | Check |
| - | - |
| A gift didn't change the light | Confirm the TikTok account, **Enable gift effects**, and the gift's switch are on. Then check whether the same gift fired in the last 5 seconds or another command was just sent. |
| **Govee did not confirm this effect** | Check that the light is online in Govee Home and that your Govee key still works, then select **Test scene**. |
| **This light is not in the connected Govee account** | You replaced your Govee key with one from another account, or the light was removed in Govee Home. Select **Edit** on that gift and choose a light and scene again. For a gift on several lights, the warning names the missing lights; select **Edit** to update its lights. |
| **This gift effect has no lights** | The effect lost its lights, so gifts don't change anything. Select **Edit**, choose its lights and scene, and select **Save changes**. |
| **Govee did not confirm this effect on 2 of 18 lights** | The named lights didn't respond; the others changed. Check those lights are online in Govee Home, then select **Test scene**. |
| A light was skipped for a gift | That light's model doesn't have a scene with that name. Pick a scene more of your lights share, or set a separate gift for that light. |
| No scenes for a light | Govee reports no scenes for that model. Try another light, or create a DIY scene in Govee Home and refresh devices. |
| Govee is rate limiting requests | Wait a minute. Other apps that use the same Govee key share Govee's limit. |
| **BrewBot paused Govee requests for this key until midnight UTC** | BrewBot's daily count for your key reached 9,999. Lights and gifts work again after midnight UTC. |
| **Set this light's resting look first** | A scene length needs something to switch back to. Select **Resting look** next to that light in **Your lights**, or **Set for all lights** to cover every light at once. Save it, then save the gift effect. |
| Light didn't switch back | Check for a warning under **Your lights**. Make sure the light is online in Govee Home and its resting look is still set. A manual power command or an untimed gift cancels the switch-back. |
| Brightness is greyed out | Govee reports no brightness control for that light. |
| Gift automation turned off by itself | Saving a new key in [Govee Cloud](https://docs.brewbot.gg/integrations/govee.md) pauses automation. Turn it back on after you check your gift effects. |

Disconnecting Govee Cloud deletes all Light Effects gift effects for the server.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.