https://github.com/michaelaquilina/lifx-cmd

:bulb: Command line tool for controlling LifX bulbs
https://github.com/michaelaquilina/lifx-cmd

Last synced: 7 months ago
JSON representation

:bulb: Command line tool for controlling LifX bulbs

• Host: GitHub
• URL: https://github.com/michaelaquilina/lifx-cmd
• Owner: MichaelAquilina
• License: bsd-3-clause
• Created: 2015-06-13T16:11:50.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2017-04-18T13:30:36.000Z (over 8 years ago)
• Last Synced: 2025-03-18T02:11:45.349Z (7 months ago)
• Language: Python
• Homepage:
• Size: 21.5 KB
• Stars: 39
• Watchers: 8
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
=====================

LifX Command Utility

=====================

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:

.. code-block:: bash

    $ pip install lifx-cmd

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

.. code-block:: bash

    $ 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:

.. code-block:: bash

    $ 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:

.. code-block:: bash

    $ 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``:

.. code-block:: bash

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

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

.. code-block:: bash

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

Features

--------

Power your bulb on and off:

.. code-block:: bash

    $ lifx power on

    $ lifx power off

Change its RGB state:

.. code-block:: bash

    $ 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:

.. code-block:: bash

    $ lifx hsb 0 1 1

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

.. code-block:: bash

    $ 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:

.. code-block:: bash

    $ 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