blink
blink(1) USB RGB LED controller command-line tool
TLDR
SYNOPSIS
blink1-tool [options]
DESCRIPTION
blink1-tool is the command-line interface for controlling blink(1) USB RGB LED indicator lights made by ThingM. It can set colors, create blink patterns, fade between colors, and manage stored light patterns on the device.
The blink(1) device is a small USB dongle containing a programmable RGB LED. It is commonly used for build status indicators, notification lights, ambient information displays, and visual alerts triggered by scripts or monitoring systems.
The tool communicates directly with the blink(1) hardware over USB HID, requiring no special drivers. Multiple devices can be addressed independently.
PARAMETERS
--rgb RRGGBB
Set color by hex RGB value.--red
Set LED to red.--green
Set LED to green.--blue
Set LED to blue.--off
Turn off the LED.--blink N
Blink the LED N times.--fade MILLIS
Fade to color over MILLIS milliseconds.--play N
Play stored pattern N.--list
List connected blink(1) devices.--savergb RRGGBB,POS
Save RGB color to position in pattern.--savepattern
Save the current pattern to the device.-l N, --led N
Select which LED to address (0=all, 1=top, 2=bottom) on blink(1) mk2+.-q, --quiet
Suppress output.
CAVEATS
Requires a physical blink(1) USB device to be connected. On Linux, udev rules may need to be configured for non-root access. The mk1 hardware supports only a single LED, while mk2 and later support two independently addressable LEDs.
HISTORY
The blink(1) was created by Tod Kurt of ThingM and successfully funded on Kickstarter in 2012. The blink1-tool command-line utility is part of the open-source blink1 software suite hosted on GitHub, supporting Linux, macOS, and Windows.

