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 201 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-headers
and 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.
Starting with Debian 10, OpenRazer is available from the official repositories. However, you may need to install our package if your device was added in a newer version.
Instructions and downloadable builds for Debian are available from the openSUSE Build Service.
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
Instructions and downloadable builds for Mageia are available on openSUSE Build Service.
Instructions and downloadable builds for openSUSE are available on openSUSE Build Service.
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.
Packages are available from the community repositories.
doas apk add openrazer openrazer-src
The kernel modules are built via akms.
Packages are available from the official repos.
sudo pacman -S openrazer-daemon
If you need the latest development builds, install openrazer-meta-git package from the AUR.
An ebuild is available, to install:
emerge -av --autounmask sys-apps/openrazer
To enable the OpenRazer module in NixOS, add this snippet to your configuration.nix
:
hardware.openrazer.enable = true;
In order to run the openrazer-daemon service, your user needs to be part of the openrazer
group.
hardware.openrazer.users = ["<name>?"];
Rebuild your NixOS configuration:
sudo nixos-rebuild switch
Alternately, use nix-shell
:
nix-shell -p openrazer-daemon
While SteamOS is based on Arch Linux, SteamOS is built differently and is more involved. Due to the immutable filesystem, you may need to reinstall OpenRazer after a system update.
We can’t help you with any issues, but a member of the community aims to keep these instructions up-to-date:
https://daniele.tech/2022/12/how-to-get-openrazer-working-easily-on-steam-deck/
Steam and the Steam logo are trademarks and/or registered trademarks of Valve Corporation in the U.S. and/or other countries.
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.
Void Linux provides these packages:
To install:
xbps-install -S openrazer-meta
These projects integrate with OpenRazer:
Python, Qt 6
Tray Applet
Qt 5
Java
GTK
Python