Lenovo Legion 5 Pro 2021 Linux RGB Keyboard Light Controller
This util allows to drive RGB keyboard light on Lenovo Legion 5 Pro 2021 Laptop
Requirements
- pyusb
Install
Regular python
git clone https://github.com/imShara/l5p-kbl
cd l5p-kbl
python -m venv env
source ./env/bin/activate
pip install -r requirements.txt
python l5p-kbl.py --help
Archlinux
sudo pacman -Sy python-pyusb
git clone https://github.com/imShara/l5p-kbl
cd l5p-kbl
python l5p-kbl.py --help
Unprivileged usage
Add udev rule if you want to swith light as unprivileged user
# /etc/udev/rules.d/10-kblight.rules
SUBSYSTEM=="usb", ATTR{idVendor}=="048d", ATTR{idProduct}=="c965", MODE="0666"
Reload rules
sudo udevadm control --reload-rules && sudo udevadm trigger
Usage
Colors
I'ts possible to set color for 4 sections of keyboard separately like COLOR COLOR COLOR COLOR, but you can set single color for whole keyboard with just COLOR. Last color will be repeated for other sections.
HEX
HEX colors should be 6-digit base 16 input like ffffff
RGB
RGB colors should be 0-255 decimal values for each component, separated by comma like 255,0,127
HSV
HSV colors should be 0.0-1.0 float values for hue, saturation, value, separated by comma like 0.0,1.0,0.25
Light effect
statiс
Static color
usage: l5p_kbl.py static [-h] [--brightness {1,2}] colors [colors ...]
positional arguments:
colors Colors of sections
optional arguments:
-h, --help show this help message and exit
--brightness {1,2} Light brightness
Turn 100% red
./l5p_kbl.py static ff0000
At full brightness, turn 100% red for 1 section, 100% green for 2 section, 100% blue for 3 section an 100% white for 4 section
./l5p_kbl.py static ff0000 00ff00 0000ff ffffff --brightness 2
Dimmed warm orange like wire heater. With HSV color input.
./l5p_kbl.py static 0.02,1,0.2
breath
Fade light in and out
usage: l5p_kbl.py breath [-h] [--brightness {1,2}] [--speed {1,2,3,4}] colors [colors ...]
positional arguments:
colors Colors of sections
optional arguments:
-h, --help show this help message and exit
--brightness {1,2} Light brightness
--speed {1,2,3,4} Animation speed
Fast white blink at full brightness
./l5p_kbl.py breath ffffff --speed 4 --brightness 2
hue
Transition across hue circle. You can't set custom colors here.
usage: l5p_kbl.py hue [-h] [--brightness {1,2}] [--speed {1,2,3,4}]
optional arguments:
-h, --help show this help message and exit
--brightness {1,2} Light brightness
--speed {1,2,3,4} Animation speed
Rotate HUE slowly
./l5p_kbl.py hue --speed 1
wave
Rainbow wawe effect. Wow. Cool. Useles.
usage: l5p_kbl.py wave [-h] [--brightness {1,2}] [--speed {1,2,3,4}] {ltr,rtl}
positional arguments:
{ltr,rtl} Direction of wave
optional arguments:
-h, --help show this help message and exit
--brightness {1,2} Light brightness
--speed {1,2,3,4} Animation speed
Wheeee, left to right
./l5p_kbl.py wave ltr
Pew-pew-pew, right to left
./l5p_kbl.py wave rtl --speed 4
off
Turn light off. Nuff said.
usage: l5p_kbl.py off [-h]
optional arguments:
-h, --help show this help message and exit
Recommendations
Set Super+Space keystroke to turn light on and turn it off with single fn+Space press
TODO
- Minimum viable product
- HSV color input
- Create setupscript
- Create Archlinux AUR package
- Advanced usage:
- Swithc light depend on keyboard layout
- Switch light depend on terminal rights
- Music light accompaniment
Payload description
Device vendor = 048d, product = c965
HEADER ........... cc
HEADER ........... 16
EFFECT ........... 01 - static / 03 - breath / 04 - wave / 06 - hue
SPEED ............ 01 / 02 / 03 / 04
BRIGHTNESS ....... 01 / 02
RED SECTION 1 .... 00-ff
GREEN SECTION 1 .. 00-ff
BLUE SECTION 1 ... 00-ff
RED SECTION 2 .... 00-ff
GREEN SECTION 2 .. 00-ff
BLUE SECTION 2 ... 00-ff
RED SECTION 3 .... 00-ff
GREEN SECTION 3 .. 00-ff
BLUE SECTION 3 ... 00-ff
RED SECTION 4 .... 00-ff
GREEN SECTION 4 .. 00-ff
BLUE SECTION 4 ... 00-ff
UNUSED ........... 00
WAVE MODE RTL .... 00 / 01
WAVE MODE LTR .... 00 / 01
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
UNUSED ........... 00
7 Sep 18, 2022
2 Feb 04, 2022
30 Nov 27, 2022
12 Dec 27, 2022
277 Jan 05, 2023
10 Oct 06, 2022
61 Dec 29, 2022
1.9k Jan 02, 2023
4 Jun 09, 2022
12 Jan 07, 2023
151 Dec 31, 2022
16 Oct 22, 2022
15 Aug 21, 2022
2 Jan 26, 2022
35 Dec 24, 2022
23 Nov 24, 2022
12 Apr 16, 2022
2.8k Dec 30, 2022
8 Oct 06, 2022
3 Feb 01, 2022