Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Sync Philips Hue lights with Plex!


  • A Plex Pass subscription
  • A computer with Git / Node 8 / NPM 5 (alternatively, a Docker image is available)


This app is the standalone equivalent of the HelloHue.bundle Plex Plugin. This is not a Plex Plugin, as Plugins will be deprecated soon.


This application detects when a media is playing, paused or stopped on your Plex Clients. Then it checks the client name, and the user who owns the stream. If it matches your criteria, it triggers your lights with the actions you have set up.

Installation with Node

  1. git clone
  2. cd HelloHue
  3. npm i
  4. npm start

Configure Plex Webhook

Plex needs to send webhooks to HelloHue in order for the channel to work. For example, if HelloHue uses the default port and is on the same machine as your Plex Media Server, the webhook url will be :

Read this support article in order to learn how to create a Plex webhook

Configure HelloHue

  • In a browser, go the HelloHue app url, for example if you are on the machine that runs HelloHue.
  1. Configure everything : Hue bridge, Plex server, Location.
  2. Then configure your Rooms. One room is composed of one Player, one or multiple User(s) and one or multiple Hue Lights/Groups. Below is some additional details about the most important settings :
    • Plex Player name you can find your Plex Players in your Plex Media Server -> settings -> Authorized devices. Only put ONE client per room. If your have two clients in the same room, activate an other room and fill the settings with the other clients name and the same lights names.
    • Plex Users names you can find the list of users in Plex Media Server -> settings -> home users. You can put multiple users (comma separated values, case sensitive).
    • You need to tick Activate this room in order for light actions to get triggered.

HelloHue api

Three endpoints are available. You may use them to integrate with homebridge or home-assistant for example :

  • GET /api/start
  • GET /api/stop
  • GET /api/status
    • Returns 1 if HelloHue is started
    • Returns 0 if HelloHue is stopped

Example docker-compose file

HelloHue is also available as a Docker image

version: "3"

    container_name: hellohue
      - ./hellohue:/app/db
      - "4568:4568"
      - TZ=Europe/Paris
    network_mode: host
    restart: unless-stopped

Example homebridge-http integration

Integrate with homebridge and homebridge-http

    	"accessory": "Http",
    	"name": "HelloHue",
    	"switchHandling": "yes",
    	"http_method": "GET",
    	"on_url":      "",
    	"off_url":     "",
    	"status_url":  "",
    	"service": "Switch",
    	"brightnessHandling": "no",
    	"brightness_url":     "http://localhost/controller/1707/%b",
    	"brightnesslvl_url":  "http://localhost/status/100054",
    	"sendimmediately": "",
    	"username" : "",
    	"password" : ""                     

Example Home-Assistant integration

- platform: command_line
      command_on: "/usr/bin/curl -X GET"
      command_off: "/usr/bin/curl -X GET"
      command_state: "/usr/bin/curl -X GET"
      value_template: '{{ value == "1" }}'
      friendly_name: HelloHue

Support the project

I've developed HelloHue on my free time, so if you like it please think about buying me a beer!


Sync your Philips Hue lights with Plex!



No releases published


No packages published