Docs Philips Hue

Entertainment Area

What a Hue Entertainment Area is, why LumaSync requires one, and how to create or edit one in the Hue app.

draft This page is awaiting owner review. Content may change.

What is an Entertainment Area

A Hue Entertainment Area is a grouping of bulbs that the Hue Bridge can drive via its low-latency streaming API instead of the default state API. Streaming trades the bridge’s normal “set colour, wait for ack” round-trip for a continuous feed of RGB frames at up to 20 Hz — fast enough for video-synced ambient lighting.

LumaSync talks to the bridge through the Entertainment API exclusively. That’s why pairing requires at least one area to exist: there’s no fallback to the slower state API.

Why the bridge caps at 20 Hz

The Hue Bridge’s Entertainment API is rate-limited at the source. Streaming faster doesn’t get you more frames — the bridge drops them and your feed stalls. LumaSync’s pipeline is tuned to hit 20 Hz exactly, no more. The telemetry pill (Σ 20 fps on the Hue target) reflects that.

If you want a faster update rate, you need a different output target — that’s what USB LED strips are for. Hue + USB can run simultaneously from the same screen source.

How to create one

Do this once, in the Hue app (iOS or Android):

  1. Open the Hue app.
  2. Go to Settings → Entertainment areas.
  3. Tap Create Entertainment area.
  4. Choose a room. The app suggests adding every bulb in that room; tap individual bulbs to include or exclude.
  5. Position each bulb on the room layout. This is what drives LumaSync’s screen-region-to-channel mapping — a bulb the app puts “top-right” will sample the top-right quadrant of your screen.
  6. Save.

Back in LumaSync, open Settings → Hue, click Refresh list, and pick your new area from the dropdown.

Bulb selection tips

Not every Hue bulb belongs in an Entertainment Area:

  • Good for Entertainment: Play bars, Lightstrip, Go, Iris, Bloom, standard E27/E14 bulbs. Anything that colour-shifts smoothly.
  • Less good: warm-white-only bulbs can still be included but only respond to the L channel, giving you a dim/bright effect without colour.
  • Avoid: motion sensors, buttons, plugs — they’re not light sources.

LumaSync uses all bulbs in the selected area. If you don’t want a particular bulb dancing along, create a smaller area that excludes it.

Positioning matters

The coordinates you set in the Hue app’s room layout aren’t cosmetic — they’re what LumaSync reads back via CLIP v2 to decide which part of the screen each bulb should sample. Position your Play bars roughly where they physically sit relative to the TV. A bulb at “back-left” will pull colour from the top-left edge of your screen.

You can fine-tune this in LumaSync’s Hue Channel Map Panel (Settings → Hue → Edit positions) without touching the Hue app — LumaSync persists overrides locally.

Multiple areas

Only one Entertainment Area can stream at a time from a given client. If you want different lighting per room (living room for movies, bedroom for reading), create one area per room and switch between them in LumaSync’s dropdown. No re-pairing needed.

Type to search. ↑↓ to navigate, ↵ to open.