busylight-for-humans 0.4.2

Control USB connected LED lights, like a human.

busylight

Control USB attached LED lights like a Human™

Make a supported USB attached LED light turn on, off and blink; all from the comfort of your very own command-line. If your platform supports HIDAPI (Linux, MacOS, Windows and probably others), then you can use busylight!

Usage

$ busylight on
$ busylight off
$ busylight on purple
$ busylight on 0xff00ff   # still purple.
$ busylight blink yellow  # all hands man your stations.
$ busylight blink red     # RED ALERT!
$ busylight off           # all clear.

Supported Lights

$ busylight supported
ThingM Blink1
Embrava BlyncLight
Kuando BusyLight
Luxafor Flag

Install

$ pip install -U busylight-for-humans
$ busylight --help

Source

busylight

Usage:

$ busylight [OPTIONS] COMMAND [ARGS]...

Options:

• -l, --light-id INTEGER: Which light to operate on, see list output. [default: 0]
• -a, --all: Operate on all lights.
• --install-completion: Install completion for the current shell.
• --show-completion: Show completion for the current shell, to copy it or customize the installation.
• --help: Show this message and exit.

Commands:

• blink: Activate the selected light in blink mode.
• list: List available lights (currently connected).
• off: Turn selected lights off.
• on: Turn selected lights on.
• supported: List supported LED lights.
• udev-rules: Generate a Linux udev rules file.

busylight blink

Activate the selected light in blink mode.

The light selected will blink with the specified color. The default color is red if the user omits the color argument. Colors can be specified with color names and hexadecimal values. Both '0x' and '#' are recognized as hexidecimal number prefixes and hexadecimal values may be either three or six digits long.

Examples:

$ busylight blink          # light is blinking with the color red
$ busylight blink green    # now it's blinking green
$ busylight blink 0x00f    # now it's blinking blue
$ busylight blink #ffffff  # now it's blinking white
$ busylight --all blink    # now all available lights are blinking red
$ busylight --all off      # that's enough of that!

Usage:

$ busylight blink [OPTIONS] [COLOR]

Options:

• -f, --faster: Increase blink speed.
• --help: Show this message and exit.

busylight list

List available lights (currently connected).

Usage:

$ busylight list [OPTIONS]

Options:

• --help: Show this message and exit.

busylight off

Turn selected lights off.

To turn off all lights, specify --all:

$ busylight --all off

Usage:

$ busylight off [OPTIONS]

Options:

• --help: Show this message and exit.

busylight on

Turn selected lights on.

The light selected is turned on with the specified color. The default color is green if the user omits the color argument. Colors can be specified with color names and hexadecimal values. Both '0x' and '#' are recognized as hexidecimal number prefixes and hexadecimal values may be either three or six digits long.

Examples:

$ busylight on          # light activated with the color green
$ busylight on red      # now it's red
$ busylight on 0x00f    # now it's blue
$ busylight on #ffffff  # now it's white
$ busylight --all on    # now all available lights are green

Usage:

$ busylight on [OPTIONS] [COLOR]

Options:

• --help: Show this message and exit.

busylight supported

List supported LED lights.

Usage:

$ busylight supported [OPTIONS]

Options:

• --help: Show this message and exit.

busylight udev-rules

Generate a Linux udev rules file.

Linux uses the udev subsystem to manage USB devices as they are plugged and unplugged. By default, only the root user has read and write access. The rules generated grant read/write access to all users for all known USB lights by vendor id. Modify the rules to suit your particular environment.

Example

$ busylight udev-rules -o 99-busylight.rules
$ sudo cp 99-busylight.rules /etc/udev/rules.d

Usage:

$ busylight udev-rules [OPTIONS]

Options:

• -o, --output PATH: Save rules to this file.
• --help: Show this message and exit.