Skip to main content

LifX command line utility to change the state of your lifx bulb. Supports powering on/off, changing RGB/HSB color and temperature.

Project description

LifX command line utility to change the state of your lifx bulb. Essentially a wrapper for the pylifx python module.

Supports powering on/off, changing RGB/HSB color and temperature.

  • Free software: BSD license

Installation

The easiest way to install this utility is using pip:

$ pip install lifx-cmd

Alternatively you can install by downloading this github repo and installing it manually:

$ git clone https://github.com/MichaelAquilina/lifx-cmd
$ cd lifx-cmd
$ python setup.py install

Setup

Assuming you’ve already connected your lifx bulb to your home network, you need to specify the master bulb you are communicating with.

The easiest way to do this is by first running the lifx-discover utility command that comes with this package:

$ lifx-discover
'wlan0' interface (broadcast address 192.168.0.255)
  IP Address:   192.168.0.38
  MAC Address:  03-1F-7B-7B-64-F6

Enter the discovered MAC address to a .lifx file in your home directory:

$ echo "03-1F-7B-7B-64-F6" > "~/.lifx"

The command utility will automatically search for this file on execution. Alternatively you can specify the MAC address from the environment variable LIFXBULB:

$ export LIFXBULB="03-1F-7B-7B-64-F6"

Finally, you can simply specify the mac address as a command line parameter:

$ lifx --bulb "03-1F-7B-7B-64-F6" power on

Features

Power your bulb on and off:

$ lifx power on
$ lifx power off

Change its RGB state:

$ lifx rgb 1 0 0   # Red light
$ lifx rgb 0 1 0   # Green light
$ lifx rgb 0 0 1   # Blue light
$ lifx rgb 1 0 1   # Magenta light

etc…

Same approach can be taken with HSB. For example:

$ lifx hsb 0 1 1

The temperature of the bulb can also be set to yellow tinge or pure white LED:

$ lifx temperature 65535   # bright white
$ lifx temperature 0       # classic yellow

By default the bulb is set to fade in changes sent over a period of 1 second. You can change this with the -f flag:

$ lifx -f 0 rgb 0 1 0           # Immediately change to green
$ lifx -f 10 temperature 65535  # Change to white over a period of 10 seconds

History

0.2.3 (2016-02-16)

  • Add lifx-discover command to discover bulbs
  • Add better help and description fields
  • Other minor improvements

0.2.0 (2015-06-21)

  • Add lifx-discover command for an easy way of discovering master bulbs on your network

0.1.2 (2015-06-21)

  • Don’t fail if only ~/.lifx is available

0.1.1 (2015-06-20)

  • Add missing read from ~/.lifx file functionality

0.1.0 (2015-06-20)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
lifx-cmd-0.2.3.tar.gz (7.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page