Skip to content

zim514/script.service.hue

Repository files navigation

Addon Checker Sync addon metadata translations License: MIT

Kodi Service for Philips Hue

script.service.hue

Automate your Hue lights on audio or video playback with Kodi Media Player

Requirements

  • Kodi 21 or higher
  • Hue Bridge V2 (Square)

Installation

Stable version

Development version

  1. Repo with auto-updates (Recommended) or Download latest .zip version
  2. Install to Kodi from Zip

Features:

  • Use standard Hue Scenes

    • Configure scenes from the official Hue app and select them in the add-on settings
    • Now supports dynamic scenes
  • Daytime configuration

    • Uses Hue's sunset and geolocation settings
    • Disable until configured morning time (default 8:00 AM)
    • If sunset falls while watching media, optionally turn on lights
    • Add-on does nothing at sunset if there's no playback
  • Scheduling

    • Set a start and end time at which the add-on should be enabled
    • Time in 24h format (Eg: 22:00, not 10:00 PM)
    • Disable during daytime setting takes precedence over active hours

Experimental Ambilight Support

You can now configure multiple lights to match playing video as closely as possible.

These settings can impact performance, and may need to be tuned for your set up.

Basic Settings:

  • Select Lights: Only Hue bulbs and lamps that support colour can be used with this system. Lights that can only reproduce whites or color temperatures are ignored.
  • Force on : Force the selected lights on when playback starts. Otherwise, lights will stay off.
  • Minimum & Maximum Brightness: Sets the brightness
  • Saturation: Increase the colour saturation factor, with 1 being no change. This can create more colourful effects, but less precision.

Performance:

Hue has a total limit of 20 commands per second which can be used by all applications and switches. Issuing too many Hue commands can cause your lights to lag or ignore input. Every selected light increases the number of necessary commands therefore influences how often lights can be updated. For more information on Hue system performance, refer to the Hue documentation.

  • Update interval: CPU and Hue impact. The minimum amount of time to wait before updating the lights, in milliseconds. 100ms will update the lights 10 times per second, 500ms, twice per second.
  • Hue transition time: Hue impact. The amount of time the lights will take to fade from one colour to the next, in milliseconds. Set to 0 for instant transition. 100ms is recommended for a quick and smooth. Hue will wait for this transition to complete before applying the next command. Normally should be the same as the update interval.
  • Capture size: CPU impact. Size at which frames are captured, in pixels of X by X. Colour calculation time is too slow with full sized frames, so they are resized first. May affect colour precision as some pixels are lost in the resize process.
  • Average image processing time: Shows the average time it took to process the colours before updating the Hue bulbs, in milliseconds. This value is updated whenever a video is stopped.

Problems?

  • Make sure you update your Hue bridge to the latest version. This add-on assumes you have the latest
  • Turn on debug logging

Includes code and contributions from: