busylight-for-humans

BusyLight Project Logo

Control USB LED status lights from the command line and HTTP.
26 devices · 9 vendors · CLI · HTTP API

Version Python Version License Monthly Downloads

BusyLight for Humans™ controls USB LED lights from multiple vendors. Use the command-line interface or HTTP API to turn lights on/off, change colors, and apply effects.

Built on busylight-core, the Python library for USB status light communication.

Flag¹, Busylight Alpha², Blynclight Plus³, Blink(1)⁴, Mute⁵, Blynclight⁶, Orb⁷, BusyLight Omega⁸, BlinkStick Square⁹, Blynclight Mini¹⁰, MuteMe Original¹¹, fit-statUSB¹², MuteSync¹³, Status Indicator¹⁴

Quick Start

# Turn on a green light right now
uvx --from busylight-for-humans busylight on

# Red, blinking, then off
uvx --from busylight-for-humans busylight blink red
uvx --from busylight-for-humans busylight off

Installation

# Basic install (CLI only)
pip install busylight-for-humans

# With web API support
pip install busylight-for-humans[webapi]

Linux requires udev rules for USB device access:

busylight udev-rules -o 99-busylights.rules
sudo cp 99-busylights.rules /etc/udev/rules.d/
sudo udevadm control -R
# Unplug and reconnect your device

Supported Hardware

Vendor	Models
Agile Innovative	BlinkStick, BlinkStick Pro, Square, Strip, Nano, Flex
CompuLab	fit-statUSB
EPOS	Busylight
Embrava	Blynclight, Blynclight Mini, Blynclight Plus, BLYNCUSB10, BLYNCUSB20
Kuando	Busylight Alpha, Busylight Omega
Luxafor	Flag, Orb, Mute, Busy Tag, Bluetooth
MuteMe	MuteMe Original, MuteMe Mini, MuteSync
Plantronics	Status Indicator
ThingM	Blink(1), Blink(1) mk2

Multi-LED targeting supported on BlinkStick variants, Luxafor Flag, and Blink(1) mk2.

Command Line

busylight on              # green light
busylight on red          # red light
busylight blink blue      # blinking blue
busylight rainbow         # cycle through colors
busylight off             # turn off

# Multi-LED devices
busylight on red --led 1  # first LED only
busylight on blue --led 2 # second LED only

Web API

# Start the server
busyserve

# Control via HTTP
curl "http://localhost:8000/light/0/on?color=red"
curl "http://localhost:8000/light/0/blink?color=blue&count=5"
curl "http://localhost:8000/lights/off"

Platform Support

macOS -- works out of the box
Linux -- requires udev rules (see Installation)
Windows -- may work, untested, patches welcome

Contributing

Contributions welcome. See CONTRIBUTING.md for development setup and guidelines. This project is part of a uv workspace monorepo.

Gratitude

Thank you to @todbot and ThingM for gifting blink(1) mk3 lights to support this project.

License

Apache License 2.0

Metadata

Release files for busylight-for-humans 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for busylight-for-humans 1.0.2
File	Size	Uploaded
busylight_for_humans-1.0.2.tar.gz	32.6 kB	Sep 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for busylight-for-humans 1.0.2
File	Interpreter	ABI	Platform	Reset
busylight_for_humans-1.0.2-py3-none-any.whl 49.7 kB Sep 5, 2026	Python 3	none	any	Details

Total release size: 82.3 kB

Release files / busylight_for_humans-1.0.2.tar.gz

Download URL	busylight_for_humans-1.0.2.tar.gz
Size	32.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`a7cd49b8e4eb3e5b99212bf63f591794b9f00339f2f7dd730bdc5c23cf7762cd`
BLAKE2b-256 checksum How to use checksums	`b5a9e659ce8a2b72bde591730d589420987bb12a578dce97edc2af3e1a8eef9a`
Upload date	Sep 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/JnyJny/busylight
Publishing commit: github.com/JnyJny/busylight/tree/03c7820d77ae1a3097afef1e20d75a06c31c457b

Workflow

Publishing configuration: github.com/JnyJny/busylight/blob/03c7820d77ae1a3097afef1e20d75a06c31c457b/.github/workflows/release-cli.yaml
Publishing logs: github.com/JnyJny/busylight/actions/runs/33986841360/attempts/1

Artifact

Subject: busylight_for_humans-1.0.2.tar.gz
SHA-256 checksum: a7cd49b8e4eb3e5b99212bf63f591794b9f00339f2f7dd730bdc5c23cf7762cd Verifying attestations

Release files / busylight_for_humans-1.0.2-py3-none-any.whl

Download URL	busylight_for_humans-1.0.2-py3-none-any.whl
Size	49.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fc39beb4a696fa00ecdb5b3b02db09899c23679a6e6f2a16fc54c0dbffdf7bcb`
BLAKE2b-256 checksum How to use checksums	`7e912c1e6a61b6037818a0299342fc79db82db9ac6d51232944aa9adf71148e7`
Upload date	Sep 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/JnyJny/busylight
Publishing commit: github.com/JnyJny/busylight/tree/03c7820d77ae1a3097afef1e20d75a06c31c457b

Workflow

Publishing configuration: github.com/JnyJny/busylight/blob/03c7820d77ae1a3097afef1e20d75a06c31c457b/.github/workflows/release-cli.yaml
Publishing logs: github.com/JnyJny/busylight/actions/runs/33986841360/attempts/1

Artifact

Subject: busylight_for_humans-1.0.2-py3-none-any.whl
SHA-256 checksum: fc39beb4a696fa00ecdb5b3b02db09899c23679a6e6f2a16fc54c0dbffdf7bcb Verifying attestations