Skip to content

bbusse/py3status-lights

Repository files navigation

py3status-lights

A py3status module to control various LED lights like WLED based devices

Currently supported are devices taking hex encoded colors for consecutive LEDs as input. A configurable amount of LEDs representing a light source can be set to either one out of a set of predefined colors - one at a time, or a custom one.

py3status-lights screenshot

Configuration

Parameters

  • leds - The number of LEDs
  • proto - The protocol to use: RGB versus DRGB
  • mode - The mode to operate the LEDs in. See Modes
  • icon - A module icon
  • icon_color - The icon to indicate the currently set color
  • color_picker - The command to run for picking a color

Modes

default

Turn on active LEDs starting at 1

center

Center all active LEDs

distribute

Spread the active LEDs evenly with equal distance between them

Usage

left-click Toggles through the predefined colors
right-click Turns off the light
scroll-up Increases the number of LEDs to control
scroll-down Decreases the number of LEDs to control

Targets

WLED

Like other firmwares, WLED can be controlled with UDP packets containing the colors to set for individual LEDs. For this to work enable UDP Sync and set the port to 2342 (the default in this module) or some other port.

Resources

py3status
py3status docs
WLED UDP