Smart Lighting

Overview

Smart Lighting lets you control your room lights directly from stream events. When a viewer sends a gift, follows, or triggers a chat command, VMSC can change light colors, adjust brightness, flash lights, or activate scenes — turning your physical space into part of the show.

VMSC provides a unified smart light output provider that supports three major brands, each using its native LAN protocol for low-latency local control:

• Philips Hue — HTTPS REST API to the local Hue Bridge.
• LIFX — UDP LAN protocol with broadcast discovery.
• Nanoleaf — HTTP REST API on port 16021.

Philips Hue

Philips Hue integration communicates with your Hue Bridge over your local network using the HTTPS REST API. No cloud account or internet connection is required once paired.

Setup

1. Discover the Bridge

   In VMSC, navigate to Outputs > Smart Lighting and select Philips Hue. Click Discover Bridge. VMSC scans your local network for Hue Bridges.

2. Press the Bridge Button

   When prompted, press the physical button on top of your Hue Bridge within 30 seconds to authorize VMSC.

3. Select Lights

   After pairing, VMSC fetches all lights and rooms from the bridge. Select which lights you want to control.

4. Test

   Click Test to flash the selected lights briefly, confirming the connection works.

• Supports individual lights, rooms, and zones.
• Scene activation uses Hue's built-in scene system.
• Color values are sent as HSB (hue, saturation, brightness) natively.

LIFX

LIFX lights connect directly over Wi-Fi with no bridge required. VMSC uses the UDP LAN protocol to communicate with LIFX bulbs on your local network.

Setup

1. Select LIFX

   In Outputs > Smart Lighting, select LIFX as the brand.

2. Discover Lights

   Click Discover. VMSC sends a UDP broadcast on the local network and lists all LIFX devices that respond.

3. Select Lights

   Choose which LIFX lights to control. Each light is shown with its label and current color.

4. Test

   Click Test to flash the selected lights.

• No API key or cloud account required.
• Supports LIFX color, white, multizone, and tile products.
• Broadcast discovery refreshes automatically on each VMSC launch.

Nanoleaf

Nanoleaf panels (Shapes, Canvas, Elements, Lines) expose an HTTP REST API on port 16021. VMSC connects directly to the panels on your local network.

Setup

1. Select Nanoleaf

   In Outputs > Smart Lighting, select Nanoleaf as the brand.

2. Enter the Panel IP Address

   Enter the IP address of your Nanoleaf controller (found in the Nanoleaf mobile app under device info).

3. Authorize

   Hold the power button on your Nanoleaf for 5–7 seconds until the LEDs flash, then click Authorize in VMSC. This generates an auth token stored locally.

4. Test

   Click Test to flash the panels.

• Supports all Nanoleaf panel types with REST API on port 16021.
• Scene/effect activation uses the panel's built-in effects library.
• Auth token persists between sessions.

Lighting Actions

The following actions are available for all supported brands through the unified smart light output provider:

Smart Lighting in Rules

Smart Lighting is available as an action target in the Rules system. When adding an action, select Smart Light and configure the action type, target lights, and parameters.

Example use cases:

• Gift alert — Flash red lights three times when a viewer sends a Rose gift.
• Follow alert — Set lights to the viewer's favorite color (using a template variable) for 10 seconds, then revert.
• Raid alert — Activate a "party" scene when a raid of 50+ viewers arrives.
• Chat command — Let viewers type !light red to change your room color (with cooldown to prevent spam).

Troubleshooting