openrgb

Open source RGB lighting control

TLDR

Start GUI

$ openrgb

List devices

$ openrgb -l

Set color on device

$ openrgb -d [0] -c [FF0000]

Set mode

$ openrgb -d [0] -m [Static]

Apply profile

$ openrgb -p [profile.orp]

Set color on a specific zone

$ openrgb -d [0] -z [0] -c [00FF00]

Start SDK server

$ openrgb --server

Start server on custom port

$ openrgb --server --server-port [1234]

OpenRGB is an open source RGB lighting control application that provides a unified interface across many hardware brands including ASUS, Corsair, Logitech, MSI, Razer, and others.The tool provides both a GUI and CLI for controlling RGB LEDs on motherboards, RAM, GPUs, peripherals, and other devices. It works cross-platform on Linux, Windows, and macOS, and includes an SDK server for remote control and integration with other applications.

PARAMETERS

-l, --list-devices

List all detected RGB devices with their index numbers.

-d INDEX, --device INDEX

Select device by index number or name. Applies to all devices if omitted.

-z INDEX, --zone INDEX

Select zone on device.

-c COLOR, --color COLOR

Set color in hex format (e.g., FF0000 for red).

-m MODE, --mode MODE

Set lighting mode (e.g., Static, Breathing, Rainbow).

-s SIZE, --size SIZE

Set zone size (for resizable zones).

-p PROFILE

Load a saved profile.

--server

Start the SDK server (default port 6742).

--server-port PORT

Set SDK server port (range 1024-65535).

--client IP:PORT

Connect to an SDK server.

-v, --verbose

Print log messages to stdout.

--startminimized

Start the GUI minimized to system tray.

--help

Display help information.

INSTALL

sudo dnf install openrgb

sudo pacman -S openrgb

sudo apk add openrgb

nix profile install nixpkgs#openrgb

CAVEATS

Hardware support varies. May need kernel modules. Root for some devices.

HISTORY

OpenRGB was created for unified RGB lighting control across different brands.