Skip to main content

A python client for the OpenRGB SDK

Project description

OpenRGB-Python

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:

  • Setting client name
  • Getting device info
  • Setting color by device
  • Setting color by zone
  • Setting color by led
  • Setting mode
  • Setting custom mode
  • Resizing zones
  • Loading profiles
  • Saving profiles

Installation

requires python >= 3.7

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

pip3 install git+https://github.com/jath03/openrgb-python#egg=openrgb-python

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

Usage

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))
motherboard.set_mode("breathing")
client.save_profile("profile1")

Documentation

https://openrgb-python.readthedocs.io/en/latest/

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openrgb-python-0.3.6.tar.gz (15.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openrgb_python-0.3.6-py3-none-any.whl (29.9 kB view details)

Uploaded Python 3

File details

Details for the file openrgb-python-0.3.6.tar.gz.

File metadata

  • Download URL: openrgb-python-0.3.6.tar.gz
  • Upload date:
  • Size: 15.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.24

File hashes

Hashes for openrgb-python-0.3.6.tar.gz
Algorithm Hash digest
SHA256 f3a8f2f21a0e810a1c74279aa6369114ef4f2b1fd35bd91c375e9429258d569b
MD5 4491479f81e15a6c68b6ed1af7371cc3
BLAKE2b-256 42f9c6c300903da4f2da84728218e93d805c811435a88170d37d8bc6cf39fb93

See more details on using hashes here.

File details

Details for the file openrgb_python-0.3.6-py3-none-any.whl.

File metadata

  • Download URL: openrgb_python-0.3.6-py3-none-any.whl
  • Upload date:
  • Size: 29.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.24

File hashes

Hashes for openrgb_python-0.3.6-py3-none-any.whl
Algorithm Hash digest
SHA256 3f2679a7464155f9bff244613edf8d459e3509e0577ba9b5c36c806cb2576d9c
MD5 5fd4da51b65fea1718f82087d3e91a82
BLAKE2b-256 f650ebb00b4dae970cf1c45c4ee96e48260daf2b368636bff88fb8045824e7e3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page