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:

• Installation instructions
  • Installation (for Mac OS X)
  • Installation (for Arch Linux)
  • Installation (for Debian/Raspbian)
  • Installation (for OpenWRT)
  • Build instructions (for Debian based systems, including Ubuntu/Raspbian)
  • Build instructions (for OpenWRT)
  • Build instructions (for other systems)
• First steps
  • Starting and stopping lightsd
  • Toggle your lights
  • Using lightsc.sh
  • Using lightsc.py
• The lights daemon protocol
  • Targeting bulbs
  • Available methods
  • Writing a client for lightsd
• Known issues
• Developers & companies
• Packaging lightsd
• Changelog
  • 1.2.1 (2017-02-12)
  • 1.2.0 (2017-02-04)
  • 1.1.2 (2015-11-30)
  • 1.1.1 (2015-11-17)
  • 1.1.0 (2015-11-07)
  • 1.0.1 (2015-09-18)
  • 1.0.0 (2015-09-17)

[1]	Currently only LIFX WiFi smart bulbs are supported.

[2]	And not over HTTP like most JSON-RPC implementations.

Indices and tables

• Index
• Search Page