#light #hue #api-wrapper #control #wrapping #command-line #command-line-tool

lighthouse

Command line tool and Philips Hue light control framework wrapping up the Hue API

3 unstable releases

0.2.1 Jul 12, 2020
0.2.0 Jul 11, 2020
0.1.0 Feb 11, 2020

#1729 in Hardware support

AGPL-3.0-or-later

58KB
553 lines

Build Status

Lighthouse

Control your Philips Hue lights with this API wrapper!

NOTE: This wrapper is under active redevelopment, see the older commits in order to get the previous iterations of the API. Also this is not a complete API wrapper for the HUE API as I do not have the time to expand the wrapper. If you would like to contribute please consider making a PR.

Also see:

lighthouse.el - an Emacs package wrapping the functionality of lighthouse (uses older version of the library)

lightshow - A simple scripting language allowing you to script your lights into lightshows (uses older version of the library)

Usage

Simply add lighthouse to the Cargo.toml and go from there.

NOTE: The features for color conversion and serialisation to and from files are now behind feature flags. Available flags are:

  • color - adds the color conversion module
  • persist - adds the ability to serialise to and from files and also to create bridges from environment variables

Command line tool

The previous releases of this library came with a binary that allowed users to control their lights from the command line. The crate has been refactored and simplified. The binary will have to be refactored as well. However the priority is to finished a more sensible API wrapper before moving onto the binary.

Contributions

I don't have the time to wrap absolutely all the endpoints and the data structures required for the API.

I would really love people to chip in over time and keep adding new functionality through extra endpoints wrapped.

Dependencies

~12–18MB
~357K SLoC