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
111 Dec 31, 2022
15 Dec 28, 2022
3 Sep 19, 2022
671 Jan 05, 2023
70 Dec 24, 2022
627 Dec 31, 2022
2.5k Jan 05, 2023
17 Nov 29, 2022
62 Dec 29, 2022
1k Jan 05, 2023
52 Oct 16, 2022
277 Jan 05, 2023
480 Dec 14, 2022
25 Dec 28, 2022
3 Oct 01, 2021
5 Jan 01, 2023
727 Jan 02, 2023
8 Nov 17, 2022
15 Oct 14, 2022
1 Nov 07, 2021