-
-
Notifications
You must be signed in to change notification settings - Fork 196
Hue Entertainment API v2
HyperHDR supports Hue gradient light strips using the new Entertainment API V2, which should also work with other types of Philips lamps. You will need the Philips Hue app to configure your lights and bridge first. For Android, you can find it here: link

Now we configure Philips Hue app: create a new entertainment group and position our lights (you just need to keep them separated / one light per each channel).
![]() |
![]() |
|---|---|
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Exit Philips Hue app. Open HyperHDR configuration page.
If you are using multiple light sources, create a new instance, start it and switch to it using the menu in the top-left section.

Go to LED Hardware tab. In the controller type select philipshue and check both Use Hue Entertainment API and Use Hue Entertainment API V2
Tip
If you decide to disable the linear output for the Hue lamps there, you can choose to increase the gamma in the processing tab, for example, to 2.2. Disabling this option is recommended because then the gamma is taken into account during the smoothing process. If it is enabled, it is applied afterward at the final stage before sending the colors to the lamp, which may result in slightly less smooth color transitions.

Your Hue bridge should be found. Otherwise you must put its IP address manually. Now click on the Create a new User and clientkey button. In the next step, you will be asked to press a button on the Hue bridge.

You should find your Hue entertainment group here. Click on the Use configuration ID button.

Now you can configure your lights (channels) position and size. You can also edit it more precisely in the next step. Save your configuration now.

If you are not satisfied with the position of the Hue lamp or the area of the screen it reflects, go to the LED Hardware tab then select LED Layout on the top. Click on the Zoom button to make the editor more accessible and readable. Right-click on the selected lamp. Now you can change its position, size and force identification (blinking).

- Getting started. Needed components
- Software installation
- Configurations
- Quick start
- Video source LUT calibration
- P010 high quality video format
- Automatic tone mapping
- Software screen capture
- Audio-reactive lighting effects
- Raspberry Pi 5 GPIO PWM 🆕
- Zigbee2MQTT lights
- Home Assistant lights
- JSON API
- Instance synchronization
- Hue gradient light strips
- HyperSerialPico and others
- Infinite Color Engine 🆕
- RGB to RGBW with dithering (by iCE) 🆕
- Compiling HyperHDR
- FAQ
- 3.3V to 5V level shifter
- Raspberry Pi OS read-only mode









