Skip to Content

Display Server Notifications Using a blink(1)

The blink(1) is an open source USB notification light that can be controlled from the command line.

blink(1) set to full green

I couldn’t find a pre-built package for it in FreeBSD but it was easy to compile directly from source. To do so, install a few dependencies and then clone the repository.

$ su

# pkg install -y gcc git gmake libiconv

# cd /tmp && git clone

Compile the blink1-tool and install it on the system.

# cd blink1-tool && gmake && install blink1-tool /usr/local/bin

# which blink1-tool

Insert the device into a USB port and make sure the system identifies it.

# dmesg
ugen0.3: <ThingM blink(1) mk3> at usbus0
uhid0 on uhub1
uhid0: <ThingM blink(1) mk3, class 0/0, rev 2.00/1.01, addr 5> on usbus0

# blink1-tool --list
blink(1) list:
id:0 - serialnum:3d5ee772 (mk3) fw version:303

The documentation explains the program’s basic usage. For example, use blink1-tool to set the LED color to green and blink it 10 times.

# blink1-tool --green --blink 10

Likewise, use --red to set the LED color to solid red. Reset the device using --off.

# blink1-tool --red

# blink1-tool --off

Use --help to see more detailed usage examples.

# blink1-tool --help