The lights daemon documentation

Welcome! This is the documentation for lightsd: a small program that runs in the background, discovers smart bulbs [1] on your local network and let you control them easily.

lightsd exposes a JSON-RPC interface over TCP IPv4/IPv6 [2] and Unix sockets. The same interface can be exposed over a named pipe: in that case responses can’t be read back from lightsd but this is useful to control your lights from very basic shell scripts.

lightsd works out of the box on Mac OS X and Arch Linux but is very easy to build thanks to its very limited requirements. Check-out the installation instructions:

[1]Currently only LIFX WiFi smart bulbs are supported.
[2]And not over HTTP like most JSON-RPC implementations.

Indices and tables