Skip to content

Device Capabilities Reference

This guide provides detailed information about each supported device's capabilities, helping you choose the right device and understand what features are available for your specific hardware.

Capability Overview

Feature Devices Description
Basic RGB Color All 26 devices Standard 0-255 RGB color control
Hardware Flash 13 devices Built-in flash patterns with configurable speed
Multi-LED Control 7 device variants Control individual LEDs (2-192 LEDs)
Audio/Sound 5 devices Built-in speaker with configurable sounds
Button Input 4 devices Physical button state detection
Advanced Programming 3 devices Pattern storage and custom sequences

Vendor Summary

Embrava (3 devices)

Professional meeting status lights with audio capabilities.

Device LEDs Flash Audio Special Features
Blynclight 1 ✓ ✓ Industry standard
Blynclight Mini 1 ✓ ✓ Compact form
Blynclight Plus 1 ✓ ✓ Enhanced brightness

Usage Example: 

from busylight_core import EmbravaLights, Blynclight

# Get all Embrava devices (any model)
embrava_lights = EmbravaLights.all_lights()
if embrava_lights:
    light = embrava_lights[0]
    light.on((255, 0, 0), sound=True)  # Red with audio alert
    light.flash((255, 255, 0))         # Flash yellow

# Or get specific Blynclight devices only
blynclights = Blynclight.all_lights()
if blynclights:
    light = blynclights[0]
    light.dim()  # Reduce brightness

Kuando (2 devices)

High-quality Nordic design status lights.

Device LEDs Flash Audio Special Features
Busylight Alpha 1 ✓ ✗ Multiple USB IDs
Busylight Omega 1 ✓ ✗ Premium model

Usage Example: 

from busylight_core import KuandoLights, BusylightAlpha

# Get all Kuando devices (any model)
kuando_lights = KuandoLights.all_lights()
for light in kuando_lights:
    light.on((0, 255, 0))  # Green

# Or get specific Alpha devices only
alpha_lights = BusylightAlpha.all_lights()
if alpha_lights:
    alpha = alpha_lights[0]
    alpha.on((255, 165, 0))  # Orange

Luxafor (5 devices)

Versatile devices with multi-LED support and button input.

Device LEDs Flash Audio Special Features
Flag 6 ✓ ✗ Multi-zone control
Orb 1 ✓ ✗ Spherical design
Bluetooth 1 ✓ ✗ Wireless capable
Mute 1 ✓ ✗ Button input
Busy Tag 1 ✗ ✗ ASCII text protocol

Usage Example: 

from busylight_core import LuxaforLights, Flag

# Get all Luxafor devices (any model)
luxafor_lights = LuxaforLights.all_lights()
if luxafor_lights:
    light = luxafor_lights[0]
    light.on((0, 0, 255))  # Works on any Luxafor device

# Multi-LED control with Flag specifically
flags = Flag.all_lights()
if flags:
    flag = flags[0]
    # Control individual LEDs
    for i in range(6):
        flag.on((255, 0, 0), led=i)  # Individual LED control

Agile Innovative BlinkStick (6 variants)

Flexible multi-LED strips and matrices for creative applications.

Device LEDs Flash Audio Special Features
BlinkStick 1 ✗ ✗ Basic model
BlinkStick Nano 2 ✗ ✗ Dual LED
BlinkStick Square 8 ✗ ✗ 8-LED matrix
BlinkStick Strip 8 ✗ ✗ LED strip
BlinkStick Flex 32 ✗ ✗ Flexible strip
BlinkStick Pro 64 ✗ ✗ Professional strip

Usage Example: 

from busylight_core import AgileInnovativeLights, BlinkStickPro

# Get all BlinkStick devices (any variant)
blinkstick_lights = AgileInnovativeLights.all_lights()
if blinkstick_lights:
    light = blinkstick_lights[0]
    light.on((255, 0, 255))  # Works on any BlinkStick

# Multi-LED animations with BlinkStick Pro specifically
strips = BlinkStickPro.all_lights()
if strips:
    strip = strips[0]
    # Create rainbow effect
    colors = [(255,0,0), (255,127,0), (255,255,0), (0,255,0), (0,0,255)]
    for i, color in enumerate(colors):
        strip.on(color, led=i)

ThingM (1 device)

Popular maker-friendly device with advanced programming.

Device LEDs Flash Audio Special Features
Blink(1) 2 ✗ ✗ Pattern storage, fade effects

Usage Example: 

from busylight_core import ThingMLights, Blink1

# Get all ThingM devices (currently just Blink1)
thingm_lights = ThingMLights.all_lights()
if thingm_lights:
    light = thingm_lights[0]
    light.on((255, 255, 255))  # Bright white

# Advanced fade effects with Blink1 specifically
blink1s = Blink1.all_lights()
if blink1s:
    blink = blink1s[0]
    # Hardware fade (if supported)
    if hasattr(blink, 'fade'):
        blink.fade((255, 0, 0), duration=2.0)

MuteMe (3 devices)

Specialized mute button devices with status indication.

Device LEDs Flash Audio Special Features
MuteMe Original 1 ✗ ✗ Button input, status LED
MuteMe Mini 1 ✗ ✗ Compact button
MuteSync Button 1 ✗ ✗ Sync-enabled

Usage Example: 

from busylight_core import MuteMeLights, MuteMe

# Get all MuteMe devices (any model)
muteme_lights = MuteMeLights.all_lights()
for light in muteme_lights:
    if light.is_button and light.button_pressed():
        light.on((255, 0, 0))  # Red when muted
    else:
        light.on((0, 255, 0))  # Green when unmuted

# Or get specific MuteMe Original devices
muteme_devices = MuteMe.all_lights()
if muteme_devices:
    mute = muteme_devices[0]
    mute.on((0, 255, 255))  # Cyan status

Other Vendors

EPOS Busylight - Professional conferencing light 

from busylight_core import EPOSLights
epos_lights = EPOSLights.all_lights()

Plantronics Status Indicator - Call center indicator 

from busylight_core import PlantronicsLights
plantronics_lights = PlantronicsLights.all_lights()

CompuLab fit-statUSB - Industrial status indicator 

from busylight_core import CompuLabLights
compulab_lights = CompuLabLights.all_lights()

Common Usage Patterns

Device Detection and Selection

Vendor-Specific Selection (Recommended): 

from busylight_core import EmbravaLights, LuxaforLights, AgileInnovativeLights

# Get devices by vendor (most efficient)
embrava_devices = EmbravaLights.all_lights()     # All Embrava devices
luxafor_devices = LuxaforLights.all_lights()     # All Luxafor devices
blinkstick_devices = AgileInnovativeLights.all_lights()  # All BlinkStick variants

# Get first device from specific vendor
if embrava_devices:
    primary_light = embrava_devices[0]
    primary_light.on((255, 0, 0), sound=True)  # Use Embrava-specific features

Unified Selection (When vendor doesn't matter): 

from busylight_core import Light

# Get all devices with audio support
audio_devices = []
for light in Light.all_lights():
    if hasattr(light, 'on') and 'sound' in light.on.__annotations__:
        audio_devices.append(light)

# Get multi-LED devices
multi_led_devices = []
for light in Light.all_lights():
    if hasattr(light, 'on') and 'led' in light.on.__annotations__:
        multi_led_devices.append(light)

Capability Testing

# Check device capabilities at runtime
def get_device_features(light):
    features = {
        'basic_color': True,  # All devices support this
        'flash': hasattr(light, 'flash'),
        'multi_led': 'led' in getattr(light.on, '__annotations__', {}),
        'audio': 'sound' in getattr(light.on, '__annotations__', {}),
        'button': light.is_button,
        'fade': hasattr(light, 'fade'),
    }
    return features

# Use features to adapt behavior
for light in Light.all_lights():
    features = get_device_features(light)

    if features['audio']:
        light.on((255, 0, 0), sound=True)
    elif features['flash']:
        light.flash((255, 0, 0))
    else:
        light.on((255, 0, 0))

Hardware Notes

USB Device IDs

Each device type uses specific USB vendor/product ID combinations. Some vendors use the same USB ID for multiple products (differentiated by firmware or physical design).

Color Ordering

Devices use different internal color formats, but the library automatically handles all conversions: - Most devices: RGB (0-255) - BlinkStick devices: GRB ordering internally - Blynclight devices: RBG ordering internally
- Kuando Busylight devices: RGB with 0-100 scaling internally

Power Requirements

All supported devices are USB bus-powered and require no external power supply.

Platform Compatibility

All devices work on Windows, macOS, and Linux. Linux users need udev rules for non-root access (see Installation Guide).

Next Steps