OpenRGB - ArchWiki

Jump to content

# OpenRGB

From ArchWiki

This article or section needs expansion.

Reason: This page needs more detailing out in terms of configuration, supported devices, troubleshooting, etc. Also needs categorization and cross-linking to and from this page (Discuss in Talk:OpenRGB)

The OpenRGB project aims to configure RGB devices while being vendor agnostic across Linux, Mac and Windows.

## Supported devices

OpenRGB supports over 2,500 different devices, and more are added all the time. A searchable list of supported devices is available in the OpenRGB website: https://openrgb.org/devices.html

## Installation

Warning OpenRGB interacts directly with hardware using reverse engineered protocols. While great efforts are made to prevent damage, there is always some risk of damage or bricking when interacting directly with hardware. By installing and using OpenRGB you accept this risk.

OpenRGB can be installed with the openrgb package, which tracks the released version.

The openrgb-gitAUR package is also available, which is equivalent to the Pipeline release of OpenRGB. It includes the latest bug fixes and hardware support, but is considered less stable.

Install the optional i2c-tools for RAM / Motherboard RGB control on desktop devices.

## Plugins

Official plugins for OpenRGB are available in the AUR. Due to API changes being implemented recently (July 2026) [1], separate packages are available to maintain compatibility:

Plugin | Plugin for Release (openrgb) | Plugin for Pipeline (openrgb-gitAUR)
--- | --- | ---
OpenRGB Effects Plugin | openrgb-plugin-effectsAUR | openrgb-plugin-effects-gitAUR
OpenRGB Visual Map Plugin | openrgb-plugin-visual-mapAUR | openrgb-plugin-visual-map-gitAUR
OpenRGB Hardware Sync Plugin | openrgb-plugin-hardware-syncAUR | openrgb-plugin-hardware-sync-gitAUR
OpenRGB E1.31 Receiver Plugin | openrgb-plugin-e131-receiverAUR | openrgb-plugin-e131-receiver-gitAUR
OpenRGB Scheduler Plugin | openrgb-plugin-schedulerAUR | openrgb-plugin-scheduler-gitAUR
Http Hooks Plugin | openrgb-plugin-http-hookAUR | openrgb-plugin-http-hook-gitAUR

Other plugins may be available: AUR search

## Troubleshooting

### Prevent hardware detection at startup

OpenRGB can be launched with `--nodetect` to skip hardware detection as it starts. This allows you to change OpenRGB settings without it interacting with your hardware.

### Disable specific hardware

If you want to disable OpenRGB from interacting with certain devices, you can disable them in Settings -> Supported Devices. If the issue prevents you from reaching this menu, see #Prevent hardware detection at startup.

### System crashes or instability

Very rarely, OpenRGB may cause system instability with certain devices. Example (now fixed): Sapphire Radeon RX 9070 XT.

The first thing to try is to upgrade to the latest Pipeline version, where it may already be fixed - see #Installation.

If the issue persists in Pipeline, you should disable the affected device in OpenRGB: #Disable specific hardware. This will prevent OpenRGB from using the device, while still allowing control of all other RGB devices. Search for open issues in the issue tracker, or open a new issue if there is none.

Hidden category:

- Pages or sections flagged with Template:Expansion

OpenRGB
Add topic