lifx-cli 0.68.0

The Unofficial LIFX CLI

The Unofficial LIFX CLI

Playing around with the LifX API with the goal of creating a feature-rich CLI.

Authentication

Authentication is done using your token stored in ~/.keys. This can be configured manually or by running lifx --configure.

Example ~/.keys ini file:

[lifx]
token = FAKE_TOKEN

Alternatively, you can override this value by setting the LIFX environment variable:

export LIFX=FAKE_TOKEN

Refer to the documentation in order to generate your own token.

Targeting Lights

The LIFX CLI primary uses device/group/scene IDs to operate, however LIFX does provide multiple options for the light 'selectors'. While not yet officially available via the CLI, you can tap into these options by prefacing your light ID accordingly (if there are spaces in the name, simply enclose in ").

lifx lights --toggle all
lifx lights --toggle "label:Left Lamp"
lifx lights --toggle "group: Upstairs Lights"
lifx lights --toggle "location_id:1d6fe8ef0fde4c6d77b0012dc736662c"
lifx lights --toggle "location:Home"

Finding the Proper ID

In order to get a listing of device and group IDs, simply run --list with the lights sub-command.

lifx lights --list

In order to get a listing of scene IDs, run the same command for scenes.

lifx scenes --list

Setting colors

Colors can be set by name, e.g. red, yellow, but the CLI also supports all methods to set the color that the API supports.

In order to see a full list of supported methods run lifx colors --list. You can also validate a color's HSBK (hue, saturation, brightness, and kelvin) via lifx colors --color red.