A community-led effort to support Razer peripherals on Linux. It consists of:
Written in C and configured to rebuild on kernel updates using DKMS
Adding persistence support, battery notifications and turning off brightness on screensaver
For integration with scripts and applications ↓
OpenRazer enables Razer-specific capabilities of the hardware, such as:
Exposing what’s supported on the firmware. Devices retain settings across power cycles*
Such as brightness, DPI** and polling rate
Enable custom lighting via software
* Not supported by all hardware. Using the device on a computer running Razer Synapse will reset this state.
** Most mice DPI hardware buttons are not intercepted and continue to use default behaviour/range.
Originally written for the BlackWidow Chroma, the driver is now compatible with 179 Razer peripherals.
A third party application is required for key rebinding, such as input-remapper.
Only lighting features are supported. OpenRazer doesn’t provide additional audio features.
Webcams with no lighting features are not supported. Try cameractrls to enable HDR and related functionality.
Before installing the driver, you’ll need to install a kernel headers package that matches your kernel version. This is because the driver is “out-of-tree” and needs to be compiled for the kernel (using DKMS).
For example, Arch has
linux-lts-headers. Other distros like Ubuntu/Debian may install them automatically, as the packaging system “recommends” the necessary package.
Before using OpenRazer, you’ll need to add your user to the
plugdev group. In most distributions, this is:
sudo gpasswd -a $USER plugdev
After following the instructions for your distribution below, a system reboot is essential so the driver and user group permissions take effect. Secure boot may need to be disabled due to the nature of the driver being unsigned.
After successful installation, reboot the computer and pick an application to interact with the driver.
We provide packages for these distros.
Due to a bug in Fedora, the wrong kernel headers (
kernel-debug-devel) may be installed and cause OpenRazer to fail installation. To fix this, you must install
kernel-devel explictly before installing OpenRazer:
sudo dnf install kernel-devel
For Fedora run the following:
sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/hardware:/razer/Fedora_$(rpm -E %fedora)/hardware:razer.repo sudo dnf install openrazer-meta
For Fedora Rawhide run the following:
sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/hardware:/razer/Fedora_Rawhide/hardware:razer.repo sudo dnf install openrazer-meta
Starting with 20.04, OpenRazer is available from the official repositories. However, you may need to install our package if your device was added in a newer version.
elementaryOS users need to install a prerequisite first:
sudo apt install software-properties-gtk
To install the latest release, add this PPA:
sudo add-apt-repository ppa:openrazer/stable
Or for latest development builds:
sudo add-apt-repository ppa:openrazer/daily
After adding the PPA, install the packages:
sudo apt update sudo apt install openrazer-meta
If you get dependency errors when trying to install the driver packages, please make sure that you have enabled the “universe” repository in Software & Updates.
Packaged and supported by the wider community.
An ebuild is available, to install:
emerge -av --autounmask sys-apps/openrazer
To enable the OpenRazer module in NixOS, add this snippet to your
hardware.openrazer.enable = true;
In order to run the openrazer-daemon service, your user needs to be part of the
hardware.openrazer.users = ["<name>?"];
Rebuild your NixOS configuration:
sudo nixos-rebuild switch
nix-shell -p openrazer-daemon
An eopkg is available, to install:
sudo eopkg install openrazer
Packages are available at the following URLs:
For details on how to install, see the SlackBuilds.org FAQ.