OpenRGB Prep prepares a Linux system for OpenRGB by checking kernel configuration, installing required tools, detecting hardware, enabling I²C access, and fixing permissions.
The script consolidates common setup steps required for RGB control on Linux and may require multiple reboots.
- Checks for required kernel parameter
acpi_enforce_resources=lax - Detects package manager (
dnf,apt,pacman) - Installs required dependencies:
pciutilsi2c-toolsdmidecode
- Detects system hardware:
- CPU
- Motherboard
- RAM
- GPU
- SMBus controller
- Enables I²C subsystem
- Loads appropriate SMBus drivers
- Fixes I²C device permissions
- Optionally installs OpenRGB
The script supports systems using:
dnf(Fedora and derivatives)apt(Debian / Ubuntu and derivatives)pacman(Arch Linux and derivatives)
- Bash
- sudo privileges
- Internet connection for dependency installation
Run the script as a normal user, not root.
Make the script executable and run it:
chmod +x OpenRGB_Prep.sh ./OpenRGB_Prep.sh
The script executes in the following stages:
PHASE 1 — Kernel Environment
PHASE 2 — Package Manager
PHASE 3 — Dependencies
PHASE 4 — OpenRGB
PHASE 5 — Hardware Detection
PHASE 6 — I²C Subsystem
PHASE 7 — Permissions
Some systems require the kernel parameter:
acpi_enforce_resources=lax
If missing, the script can update GRUB and rebuild the configuration. A reboot will be required afterward.
MIT License