Awesome Open Source
Awesome Open Source


Documentation Status

OpenRGB-Python is a client for the OpenRGB SDK, a manufacturer-independent, cross-platform way to control your RGB devices. OpenRGB-Python can be used to interface with other programs, create custom effects, or anything else you can think of!

I started this project because I wanted to be able to control the color of my lights based on temps. I tried to implement the features in the best (easiest to use) way possible.

SDK Feature Support:

  • [x] Setting client name
  • [x] Getting device info
  • [x] Setting color by device
  • [x] Setting color by zone
  • [x] Setting color by led
  • [x] Setting mode
  • [x] Setting custom mode
  • [x] Resizing zones

Additional Features (Not part of the OpenRGB SDK):

  • [x] Loading profiles
  • [x] Saving profiles


requires python >= 3.7

Use this method for the newest, but possibly buggy, package:

pip3 install git+

Arch Linux: yay -S python-openrgb-git

For a more stable package:

pip3 install openrgb-python

Arch Linux: yay -S python-openrgb This AUR package is out of date. Use python-openrgb-git instead.

Thanks to @GabMus for the AUR packages


from openrgb import OpenRGBClient
from openrgb.utils import RGBColor, DeviceType

client = OpenRGBClient()

client.clear() # Turns everything off

motherboard = client.get_devices_by_type(DeviceType.MOTHERBOARD)[0]

motherboard.set_color(RGBColor(0, 255, 0))
motherboard.zones[0].set_color(RGBColor(255, 0, 0))
motherboard.zones[1].leds[0].set_color(RGBColor.fromHSV(0, 100, 100))


For an alternative python implementation, check out B Horn's OpenRGB-PyClient

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (837,714
Python3 (837,705
Sdk (32,763
Python Client (1,265
Aur Packages (160
Led Controller (139
Openrgb (12