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

# pkg install -y gcc git gmake libiconv
[...]

# cd /tmp && git clone https://github.com/todbot/blink1-tool
[...]

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

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

# which blink1-tool
/usr/local/bin/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
[...]