How to Configure Razer Devices Using RazerGenie on Linux

RazerGenie is an open-source Linux app for configuring supported Razer peripherals. It adjusts RGB lighting and brightness and, on compatible mice, DPI stages and polling rate. It relies on OpenRazer, so the driver and daemon must be installed on the host before RazerGenie—especially its Flatpak build—can detect devices.

The OpenRazer supported-devices page with keyboard and mouse categories.
Check OpenRazer's supported-device list before installing the driver.

1. Check support and install OpenRazer

Check your exact model in the official OpenRazer device list. Stable and development support can differ, so a model listed only on the development branch may need a newer package. Use the current installation guide if your release is not covered below.

OpenRazer uses DKMS to build a kernel module. Install headers matching your running kernel if your package manager does not add them; Ubuntu and Debian often pull them automatically.

Ubuntu, Linux Mint, elementary OS, Pop!_OS, and Zorin OS

For the latest stable release, add the OpenRazer PPA and install its meta-package. On elementary OS, install the PPA helper first if needed.

sudo apt install software-properties-gtk
sudo add-apt-repository ppa:openrazer/stable
sudo apt update
sudo apt install openrazer-meta

The helper command is mainly for elementary OS; run it elsewhere only if needed.

Ubuntu terminal commands adding the OpenRazer stable PPA and installing openrazer-meta.
The stable PPA provides the OpenRazer package used by RazerGenie.

Fedora and Nobara 41 or later

For Fedora 41 and later, install the matching kernel development package, add the OpenRazer repository, and install the driver:

sudo dnf install kernel-devel
sudo dnf config-manager addrepo --from-repofile=https://openrazer.github.io/hardware:razer.repo
sudo dnf install openrazer-meta

Older Fedora releases use different repository syntax; check the current guide.

Fedora terminal showing kernel-devel, the OpenRazer repository, and openrazer-meta installation commands.
Fedora users should follow the repository instructions for their exact release.

Arch Linux

Install OpenRazer and the headers matching your kernel flavor:

sudo pacman -S openrazer-daemon
sudo pacman -S linux-headers

Use linux-headers for the standard Arch kernel; for another kernel flavor, install its matching header package. The daemon package depends on the OpenRazer driver package. See the official Arch package list for current package details.

Arch Linux terminal with the openrazer-daemon package installation command.
Arch packages OpenRazer through its official repositories.

For Debian, start with the official package search; newer device support may require the OpenSUSE Build Service. The OBS page also covers openSUSE. Avoid outdated release-specific repository commands.

2. Set permissions and reboot

OpenRazer needs your user account to belong to the group that grants access to the device files. On most distributions, use plugdev:

sudo gpasswd -a $USER plugdev

On Arch-based distributions, current OpenRazer troubleshooting guidance says to use the openrazer group instead:

sudo gpasswd -a $USER openrazer

Reboot after installing the driver and changing group membership so the kernel module and permissions are reloaded.

A Linux terminal adding the current user to the plugdev group.
Most distributions use plugdev; Arch-based systems use the openrazer group.

If the driver will not load, check the kernel headers and DKMS build. Secure Boot can block unsigned modules; see the official troubleshooting guide before changing firmware settings.

3. Install RazerGenie

Flatpak works across distributions. If Flathub is not configured, add the remote and install RazerGenie:

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub xyz.z3ntu.razergenie

Confirm the installation when prompted. The Flathub listing notes that OpenRazer must be installed outside Flatpak. The project README lists native package options.

A Linux terminal adding Flathub and installing the xyz.z3ntu.razergenie Flatpak.
Install the GUI only after OpenRazer is installed on the host system.

4. Configure your Razer device

After rebooting, open RazerGenie from the application menu and select a device in the left sidebar. Controls depend on the model and OpenRazer support.

RazerGenie with a supported BlackWidow keyboard selected in the device sidebar.
Select the keyboard, mouse, or other supported device you want to configure.

Change lighting effects and brightness

In Lighting, choose an available effect—such as Static, Breathing, Spectrum Cycling, Wave, or Reactive—and set a color if offered. Effects vary by device.

RazerGenie's Lighting page with the effect dropdown expanded and Spectrum Cycling selected.
Choose one of the lighting effects supported by your device.

Use the brightness slider to dim or brighten the lighting. If available, open Open Custom Lighting Editor to assign colors to keys or zones; supported controls vary by model.

RazerGenie lighting controls showing an effect selector and a brightness slider set to 70 percent.
Adjust brightness independently from the selected lighting effect.
RazerGenie's custom lighting editor displaying a keyboard with per-key RGB colors.
Use the custom editor for per-key or per-zone lighting when the hardware supports it.

Adjust mouse DPI

For a compatible mouse, open DPI and edit a sensitivity stage. Some devices expose separate X and Y values or a control to link them. Values in the illustration are examples; stages and maximum DPI depend on the mouse.

RazerGenie's mouse DPI page with several sensitivity stages and separate X and Y values.
Set only DPI stages and values supported by your mouse.

Change the polling rate

Open Polling Rate and choose an available value. Common options include 125, 250, 500, and 1,000 Hz, but supported rates vary by mouse and may depend on its receiver. Do not assume the highest rate is available.

RazerGenie's Polling Rate page with 500 Hz selected for a supported mouse.
Choose from the polling rates the connected device actually exposes.

5. If RazerGenie does not detect your device

  • Check USB detection: run lsusb | grep 1532, then compare the product ID with the stable support list.
  • Check the daemon: run systemctl --user status openrazer-daemon.service; if stopped, try systemctl --user restart openrazer-daemon.service.
  • After kernel updates: confirm the matching headers are installed and DKMS built the module for the running kernel.
  • Rule out USB issues: reconnect the device, try a direct port instead of a hub or KVM switch, and reopen RazerGenie.

Once OpenRazer detects the hardware, RazerGenie provides a convenient graphical way to adjust the lighting and device controls that the specific peripheral supports.

Leave a Comment

How to Record Speaker Output on Linux with Audacity

How to Record Speaker Output on Linux with Audacity

Capture Linux desktop audio in Audacity by routing its recording stream to your output device’s monitor source. Follow PulseAudio and PipeWire steps, export tips, and fixes for silent tracks.

How to Use Dropbox on Linux: Install and Sync Your Files

How to Use Dropbox on Linux: Install and Sync Your Files

Install Dropbox on Linux from the official package, sign in, sync a local folder, manage selective sync, and check status from the command line.

How to Install Inkscape on Linux: Ubuntu, Fedora, Arch, and More

How to Install Inkscape on Linux: Ubuntu, Fedora, Arch, and More

Install Inkscape from your Linux distribution’s repositories, the Ubuntu stable PPA, Snap, or Flathub, with current commands and notes for choosing a package source.

How to Find and Remove Duplicate Files on Linux With FSlint

How to Find and Remove Duplicate Files on Linux With FSlint

Use FSlint to scan selected Linux folders, review duplicate groups, and safely delete redundant files or learn when hard-link merging is appropriate.

How to Install SABnzbd on Linux and Configure It

How to Install SABnzbd on Linux and Configure It

Install SABnzbd on Ubuntu or Debian, or run it in Docker on another Linux host. Then open the web interface and configure your provider and download folders.

How to Install the Paper GTK Theme on Linux

How to Install the Paper GTK Theme on Linux

Install the Paper GTK theme from supported Linux repositories, enable it for GTK apps in GNOME Tweaks, and see what the legacy theme can and cannot change.

How to Install and Set Up Plex on OpenMediaVault with Compose

How to Install and Set Up Plex on OpenMediaVault with Compose

The old OpenMediaVault Plex plugin is archived. Set up Plex on OMV 8 with OMV-Extras, the Compose plugin, persistent storage, and Plex’s official container.

How to Clean and Speed Up Ubuntu Safely

How to Clean and Speed Up Ubuntu Safely

Clean and speed up Ubuntu with safe APT cleanup, storage checks, and startup controls that help free space and troubleshoot a sluggish desktop.

How to Install the Hiri Email Client on Linux

How to Install the Hiri Email Client on Linux

Install Hiri on Linux with its Snap package or official tarball, add a desktop launcher, and check supported accounts plus a warning about Hiri’s old Snap release.

How to Get System Specifications for a Linux PC

How to Get System Specifications for a Linux PC

Use Fastfetch and built-in Linux commands to check your distro, kernel, CPU, memory, graphics, storage, and connected devices, then save a clear report.