Skip to content
An API managing LIFX devices in a local network.
Go Dockerfile Makefile
Branch: master
Clone or download


Since Horus was said to be the sky, he was considered to also contain the sun and moon.

horus illustration


The API has only been tested with LIFX Mini White.

This project is a POC and does not have to be used in a production environment.

What is Horus?

Horus is an API which handles your LIFX devices in your local network. It uses UDP packets to interact with them. It has been designed to simplify your interactions with your LIFX devices, without cloud connection.

Getting started

Edit your config file and your list of LIFX devices

  1. Go in config.yaml.
  2. Follow the documentation.

Run the application

  1. Install Docker and docker-compose
  2. Optional Edit the environment variables in the docker-compose.yml file.
  3. Download and launch the container
$ docker-compose up -d
  1. Read the Swagger documentation.
  2. Use it!

Example of curl:

# Get all of your LIFX devices
$ curl -iL -X GET 'localhost:2020/lights/'

# Toggle your lights
$ curl -iL -X POST -H "Content-Type:application/json" --data '{"duration":1500}' 'localhost:2020/lights/toggle?selector=all&key=086bf714-7d7f-4f1c-a195-ba2809827374'

# Toggle your light with the UUID `33d07008-2082-4d7f-82f3-04c275b70055`
$ curl -iL -X POST -H "Content-Type:application/json" --data '{"duration":1500}' 'localhost:2020/lights/toggle?selector=uuid:33d07008-2082-4d7f-82f3-04c275b70055&key=086bf714-7d7f-4f1c-a195-ba2809827374'

# Edit the color, the power status and the label your light called `foo`
$ curl -iL -X PUT -H "Content-type:application/json" --data '{
  "hsbk": {
    "hue": 65535,
    "saturation": 65535,
    "brightness": 10000,
    "kelvin": 9000
  "duration": 1500,
  "power": "on",
  "label": "bar"
}' 'localhost:2020/lights/state?selector=label:foo&key=086bf714-7d7f-4f1c-a195-ba2809827374'

Swagger documentation

You can find the documentation here.

You can also generate the Swagger (OpenAPI) documentation by running the application and going on:


# Or with curl
$ curl -X GET 'localhost:2020/unsecured/openapi.json'

TODO list:

  • Add location and group routes (/lights/group & /lights/location
  • Try with other devices such as Mini Color, Tile Kit, Plus
  • Open to other brands
You can’t perform that action at this time.