This is a program written in Python to control the RGB lighting of devices. PyUSB was chosen to send serial commands to the devices. The motivation was for me to understand more about how USB communication works, and involved reverse engineering the propietary software using a USB packet capturing program. I have started with supporting the SteelSeries Apex 3 TKL because it is the keyboard I am using. I've tried to futureproof the code somewhat to add additional devices in the future if and when I need to.
- SteelSeries Apex 3 TKL.
This program has only been tested using vanilla Fedora 40.
You must have the following installed to run certain parts of the program:
You must either run the code as root, or set up custom udev rules for individual devices that you wish to control. Please see this discussion for guidance.
The recommended way to run this program is using the GUI:
$ python /path/to/script/RGB_controller_GUI.py
The GUI currently only supports setting a single static colour.
Alternatively, the program can be called by entering the following command into a Terminal window:
$ python /path/to/script/RGB_controller.py
This comes with additional functionality of setting colours by zone or setting a rainbow wave effect.
This will scan and list the supported devices that are connected to your system. Selecting the device then brings up the modes supported, such a single static colour, multi-zone static colours, and a rainbow wave. Brightness and colours are then specified.
The external_input function can be used to set a colour directly, for example via a custom keyboard shortcut. This was included because - on my system anyway - the SteelSeries Apex 3 TKL resets to the rainbow wave when waking the computer. An example shortcut to run this with a white backlight at full brightness would be:
$ cd /path/to/script; python -c 'import RGB_controller; RGB_controller.external_input(10, "ffffff")'