Connects Philips Hue LED Bulbs, Friends of Hue LED Lamps and Stripes and other SmartLink capable Devices (LivingWhites, some LivingColors) via Philips Hue Bridges
npm install iobroker.hue!Logo
!Number of Installations
!Number of Installations

!Test and Release


This adapter uses the service Sentry.io to automatically report exceptions and code errors and new device schemas to me as the developer. More details see below!
When the adapter crashes or another Code error happens, this error message that also appears in the ioBroker log is submitted to Sentry.
When you have allowed ioBroker GmbH to collect diagnostic data, then also your installation ID (this is just a unique ID without any additional infos about you, email, name or such) is included. This allows Sentry to group errors and show how many unique users are affected by such an error. All of these helps me to provide error-free adapters that basically never crash.
Please note: Adapter settings button "Find Bridge" will be inactive if field "Bridge Address" is populated, and button "Create User" will be inactive if field "Bridge User" is populated.
Find Bridge button. |Create User button and following the screen instructions. |hue.... . The new structure removes and thus makes it necessary to adapt old scripts, etc. If an existing old structure is detected by the adapter, the structure will be used without checking the checkbox. However, if migration from old to new structure is desired, delete the whole hue. namespace once. |status datapoint of such a sensor you can start/stop scenes which follow this logic. In most cases 0 turns scene off and 1 turns it on. |false and turn on only with power and brightness state. | hue.0.All.command) can be used to set multiple commands to the bridge. ``javascript`
setState('hue.0.All.command', { "bri": 50, "transitiontime": 30 }, false);
For groups which contain scenes, like hue.0.Wohnzimmer.scene_hell the scenes can also be activated with a transition time.
To do this, pass the scene argument to the corresponding command.
`javascript`
setState('hue.0.All.Wohnzimmer', { "scene": "hell", "transitiontime": 30 }, false);
and allOn became controllable, note that they will just act like the on state,
when controlled. In some cases, it may be desirable to have a controllable anyOn state in your visualization.Deutsch :de:
Bindet Philips Hue / LivingColors / LivingWhites Lampen ein.
In den Adapter-Settings muss die IP der Hue Bridge sowie ein Username konfiguriert werden. Um einen User zu aktivieren, einmal auf create user drücken und dann innerhalb von 30 Sekunden den Button an der Hue bridge drücken. Dann wird automatisch der User übergeben. Changelog
$3
* (@foxriver76) do not try to use v2 functionality on legacy Hue bridges (closes #720)$3
* (@foxriver76) fix if no tamper report is present on state creation$3
* (@foxriver76) added tamper states for contact sensors$3
* (@foxriver76) added support for contact sensors$3
* (@foxriver76) improved error handling for smart scenes$3
* (@foxriver76) added dynamic scenes (Note: new states are added by UUID)$3
* (@foxriver76) correct min color temperature to 2000 (valid for color lights) instead of 2200$3
* (@Jey-Cee) optimized settings page for mobile devices (ported to json-config)$3
* (foxriver76) level and bri states of groups are now updated via push API$3
* (seb2010) added possibility to use global light-scenes in commands (in addition to object-lightscene)
* (foxriver76) dropped support of node 16 (End-Of-Life)$3
* (foxriver76) bring back short delay between setting and polling a group
* (foxriver76) use adapter internal timer methods$3
* (foxriver76) fixed frontend/backend communication (closes #481)$3
* (foxriver76) fixed problem on auto-deletion of groups
* (foxriver76) implemented Hue Tap Dial (closes #368, closes #416)$3
* (foxriver76) do not set invalid states on unknown group updates
* (foxriver76) only use push connection if ssl is configured$3
* (foxriver76) fixed crash case$3
* (foxriver76) fixed the edge case crash on button updates
* (foxriver76) fixed crash case if uuids cannot be retrieved$3
* (foxriver76) fixed crash cases on unknown push updates (closes #417)$3
* (foxriver76) fixed sensor converting (closes #415)$3
* (foxriver76) implemented more commands of the Push API (mainly buttons)$3
* (foxriver76) implemented poll API (closes #227, #343)
* (foxriver76) fixed polling not working (closes #408, #410)$3
* (Schmakus) Possibility to disable turn on lights with states other than on and brightness [#386]$3
* (Eistee82) also update state for CLIPGenericFlag sensors$3
* (foxriver76) support software sensor CLIPGenericFlag (closes #328)$3
* (foxriver76) correctly identify third party switches (closes #273)$3
* (foxriver76) added info.connection state (closes #268)$3
* (foxriver76) ct values of groups can be even lower due to third party lights$3
* (foxriver76) allow triggering scenes via command state, this allows starting a scene with transitiontime$3
* (foxriver76) ct value fixed of #234 ported for 0 (All) group$3
* (foxriver76) we fixed Sentry IOBROKER-HUE-1K, IOBROKER-HUE-A, IOBROKER-HUE-1J$3
* (bluefox) Caught SENTRY error.$3
* (foxriver76) another fixed for invalid ct values (fixes #234)$3
* (foxriver76) we fixed missing object type of some scenes (closes #255)$3
* (foxriver76) fixed an issue with the username set in Hue API (fixes 249)
* (klein0r) fixed translation of search popup (fixes #247)$3
* (foxriver76) if we cannot determine the correct ct value, we won't set it (fixes #234)$3
* (Pmant) fixed for third party devices delivering wrong ct values$3
* (foxriver76) fixed several sentry issues (closes #217, closes #218, closes #219, closes #220)$3
* (foxriver76) we now define minimum ct of groups to 2000 instead of 2179 (fixes #216)$3
* (foxriver76) fixed crash case if we cannot get min/max ct values$3
* (foxriver76) get the correct min/max ct values from api for lights (closes #192)$3
* (foxriver76) prevent edge case crash (fixes #196)$3
* (foxriver76) make buttons type boolean (closes #189)$3
* (foxriver76) fixed some default type values, which produced warnings once$3
* (foxriver76) protect the user token from access by foreign adapters
* (foxriver76) fixed types of default values on groups$3
* (foxriver76) we fixed some more types$3
* (foxriver76) we give skipped switches common.type 'mixed' instead of none
* (foxriver76) we have corrected the min max of color temperature (empirically found)$3
* (foxriver76) we now update objects if a type has changed$3
* (foxriver76) we removed the common.max from lightlevel, was 17,000 but can be much higher
* (foxriver76) we added common.type for states where the attribute was missing$3
* (foxriver76) start this adapter in TIER 2$3
* (foxriver76) minor changes$3
* (foxriver76) fixed a bug where an error on user creation crashed the adapter instance$3
* (foxriver76) fixing several edge case crashes$3
* (foxriver76) fixed crashes if wrong data type or invalid value passed for ct and hue, now logging an error
* (foxriver76) fixed crashes if rgb where outside allowed range or wrong type
* (foxriver76) fixed potential crashes on bridge discovery, due to unnecessary stringify/parse logic
* (foxriver76) fixed a graphical issue with the label of bridge user when newly created, due to missing call of updateTextFields$3
* (foxriver76) avoid crash cases on invalid xy, setting state for non-existing device and on failing user creation$3
* (foxriver76) use official js-controller regex for replacing forbidden chars (fixes #165)
* (foxriver76) use release-script
* (foxriver76) sentry added$3
* (foxriver76) we now restart the adapter automatically to add new devices if they have been added to bridge$3
* (foxriver76) fixed updating anyOn and allOn if legacy structure used$3
* (foxriver76) we do not set states of non-existing states anymore$3
* (foxriver76) marked read-only states accordingly$3
* (Apollon77) do not catch undhandeledRejections anymore, because controller can handle and report now
* (foxriver76) dependencies updated
* (foxriver76) temperature is now correctly read-only
* (foxriver76) fixed duplicate filtering on browse$3
* (foxriver76) fixed issue on frontend validation of polling intervals starting with 1$3
* (foxriver76) implemented fixed for problems with switches and handling id conflicts$3
* (foxriver76) we now handle potential id conflicts, when adding devices from a different type with same name over time$3
* (foxriver76) internal optimizations - polling after change timeout removed, was 150 ms now instant$3
* (foxriver76) introduce allOn state for groups
* (foxriver76) anyOn and allOn are now controllable and act like the on state
* (foxriver76) when native turn on/off behaviour is used, the brightness change of partially turned on groups will not turn
the whole group on, like the hue app does, instead it will only change the brightness of the currently turned on lamps$3
* (foxriver76) fixed issues on user creation
* (foxriver76) minor frontend (admin config) optimizations$3
* (foxriver76) replace dots in light/group/sensor/.. names by underscores
* (foxriver76) fixed potential state update delay after state change on lights/groups containing blanks$3
* (xXBJXx) changed role of battery to value.battery and made unit %$3
* (Apollon77) minor fixed regarding handleParam called with non-existing id$3
* (foxriver76) fixed potential issues when error type is not HueError$3
* (foxriver76) if lights/groups/sensors are deleted during runtime, restart of adapter is no longer necessary
* (foxriver76) if controller supports recursive deletion, device will be deleted automatically$3
* (foxriver76) added additional frontend validation of polling interval
* (foxriver76) if errors are hue errors, log message instead of Error$3
* (foxriver76) added new indicators for entertainment groups (class and activeStream)
* (foxriver76) added possibility to enable/disable streaming of entertainment group$3
* (foxriver76) fixed turning on/off switchs like Osram Plug$3
* (foxriver76) removed queue, because handled by dependency now
* (foxriver76) improved error handling
* __Nodejs >= 10 required__$3
* (foxriver76) implemented a mechanic to prevent regular polling of recently changed state
* (foxriver76) this prevents fluctuating of buttons on low polling intervals + possible strange triggers in scripts$3
* (foxriver76) do not set default values on every adapter start
* (foxriver76) this is now done only on object creation$3
* (foxriver76) log unhandeld promise rejections
* (foxriver76) fixed potential issue for negative temperature values$3
* (foxriver76) only stringify huge jsons if necessary
* (foxriver76) prevent possible double polling at adapter start
* (foxriver76) use timeouts instead of interval
* (foxriver76) improved performance$3
* (foxriver76) increased version of node-hue-api to fixed authentication for old bridge$3
* (foxriver76) we now use nupnp + upnp to discover bridges (previously only upnp)$3
* (foxriver76) added possibility to control zones and entertainment areas
* (foxriver76) log queue retires on debug instead warn
* (foxriver76) __BETA__: added possibility to control software sensors (Note: this may be handled in a more suitable fashion soon)$3
* (foxriver76) fixed controlling on` state of sensors* (hobbyquaker) fixed min/max attributes
* (hobbyquaker) added common.oper.read/write attributes
* (hobbyquaker) first release
* Automatic bridge discovery
* Automatic user setup via bridge link button
Apache 2.0
Copyright (c) 2017-2025 Bluefox
Copyright (c) 2014-2016 hobbyquaker