This Python API provides an interface for controlling the RGB lighting of keyboards that support the VIA protocol. It allows you to dynamically change the brightness, effect, effect speed, and color of the lighting.

• Set lighting brightness
• Set lighting effect
• Set lighting effect speed
• Set lighting color in RGB or HSV format (HS only)
• Set absolute lighting color (real RGB color instead of HS only)
• Color correction algorithm allows to display accurate colors
• Save lighting settings to EEPROM

• Python 3.x

pip install via-lighting-api

See a full example code in example.py.

First, import the ViaLightingAPI class from the module where it’s defined:

from via_lighting_api import ViaLightingAPI

To initialize the API and control the lighting, you need to know the Vendor ID (VID) and Product ID (PID) of your keyboard. If you don't know these values, run: via-lighting-api --list-devices and follow the hint to find them.

# Replace with your keyboard's VID and PID vid = 0x1234 pid = 0xABCD # Initialize the API api = ViaLightingAPI(vid, pid)

# Set brightness to maximum api.set_brightness(255)

# Set effect to 'Rainbow Moving Chevron' api.set_effect(15)

# Set effect speed to medium api.set_effect_speed(127)

# Set color to red (in RGB) api.set_color([255, 0, 0]) # Set color to blue (in HSV) api.set_color([170, 255])

Set absolute lighting color (adjust both HS color and brightness), RGB format supported.

The effect will be better only if your keyboard switch has a light-guiding design or the color saturation of the switch is low, because the color displayed will be greatly biased towards the color of the switch when the light brightness is low.

If not, try out the color correction function.

# Set absolute color to purple api.set_color_abs([128, 0, 128])

This is useful when your keyboard switches do not have light guide designs, or they have highly saturated colors, and you want them to display accurate colors.

To use it, you first need to test the RGB values of the light settings when your keyboard displays true white.

This algorithm only applies to set_color_abs()

# Enable color correction api.set_color_correction([150, 240, 60]) # Disable color correction api.disable_color_correction()

# Save current lighting settings to EEPROM api.save()

If your device is not detected, ensure that it is connected properly and that you have the correct VID and PID. Also, check that your keyboard firmware supports VIA control.

This API provides an interface that can send user-defined commands directly to your device, which may cause unexpected results if used improperly. Make sure you fully understand the VIA protocol and the commands you are sending.

This API is open-source and can be used and modified by anyone. Please respect the original author’s work when using or distributing this software.