What is OpenRazer?

A community-led effort to support Razer peripherals on Linux. It consists of:

Linux Kernel Module

Written in C. Configured to rebuild on kernel updates (via DKMS)

Daemon

Adding persistence support, battery notifications and turning off brightness on screensaver

Python Library

For integration with apps and scripts

View apps ↓

Features

OpenRazer enables Razer-specific capabilities of the hardware, such as:

Hardware Effects

Exposing what's supported on the firmware. Devices retain settings across power cycles*

Device Functions

Such as brightness, DPI** and polling rate

Addressable RGB

Enable custom lighting via software

* Not supported by all hardware. Plugging the device into a computer running Razer Synapse will reset this state.

** Most mice DPI hardware buttons are not intercepted and continue to use default behaviour/range.

Devices

Originally written for the BlackWidow Chroma, the driver is now compatible with 168 Razer peripherals.


  Supported Keyboards


Anansi
1532:010F
BlackWidow 2019
1532:0241
BlackWidow Chroma
1532:0203
BlackWidow Chroma (Overwatch)
1532:0211
BlackWidow Chroma Tournament Edition
1532:0209
BlackWidow Chroma V2
1532:0221
BlackWidow Elite
1532:0228
BlackWidow Essential
1532:0237
BlackWidow Lite
1532:0235
BlackWidow Stealth
1532:011B
BlackWidow Stealth Edition
1532:010E
BlackWidow Tournament Edition 2014
1532:011C
BlackWidow Ultimate 2012
1532:010D
BlackWidow Ultimate 2013
1532:011A
BlackWidow Ultimate 2016
1532:0214
BlackWidow V3
1532:024E
BlackWidow V3 Mini Hyperspeed
1532:0258
1532:0271
BlackWidow V3 Pro
1532:025A
BlackWidow V3 Tenkeyless
1532:0A24
BlackWidow X Chroma
1532:0216
BlackWidow X Chroma Tournament Edition
1532:021A
BlackWidow X Ultimate
1532:0217
Blade (Late 2016)
1532:0224
Blade 14 (2021)
1532:0270
Blade 15 (2018)
1532:0233
Blade 15 (2018) Base Model
1532:023B
Blade 15 (2018) Mercury
1532:0240
Blade 15 (2019) Advanced
1532:023A
Blade 15 (2019) Base Model
1532:0246
Blade 15 (Mid 2019) Mercury White
1532:0245
Blade 15 Advanced (2020)
1532:0253
Blade 15 Advanced (Early 2021)
1532:026D
Blade 15 Advanced (Early 2022)
1532:028A
Blade 15 Advanced (Mid 2021)
1532:0276
Blade 15 Base (Early 2020)
1532:0255
Blade 15 Base (Early 2021)
1532:026F
Blade 15 Studio Edition (2019)
1532:024D
Blade 17 (2022)
1532:028B
Blade 17 Pro (Early 2021)
1532:026E
Blade 17 Pro (Mid 2021)
1532:0279
Blade Pro (2017)
1532:0225
Blade Pro (2019)
1532:0234
Blade Pro (Early 2020)
1532:0256
Blade Pro (Late 2016)
1532:0210
Blade Pro (Late 2019)
1532:024C
Blade Pro FullHD (2017)
1532:022F
Blade Stealth
1532:0205
Blade Stealth (2019)
1532:0239
Blade Stealth (Early 2020)
1532:0252
Blade Stealth (Late 2016)
1532:0220
Blade Stealth (Late 2017)
1532:0232
Blade Stealth (Late 2019)
1532:024A
Blade Stealth (Late 2020)
1532:0259
Blade Stealth (Mid 2017)
1532:022D
Blade Stealth (QHD)
1532:020F
Book 13 (2020)
1532:026A
Cynosa Chroma
1532:022A
Cynosa Chroma Pro
1532:022C
Cynosa Lite
1532:023F
Cynosa V2
1532:025E
DeathStalker Chroma
1532:0204
DeathStalker V2
1532:0295
Deathstalker Expert
1532:0202
Huntsman
1532:0227
Huntsman Elite
1532:0226
Huntsman Mini
1532:0257
Huntsman Mini (JP)
1532:0269
Huntsman Mini Analog
1532:0282
Huntsman Tournament Edition
1532:0243
Huntsman V2
1532:026C
Huntsman V2 Analog
1532:0266
Huntsman V2 Tenkeyless
1532:026B
Ornata
1532:021F
Ornata Chroma
1532:021E
Ornata V2
1532:025D

  Supported Mice


Abyssus 1800
1532:0020
Abyssus 2000
1532:005E
Abyssus 2014
1532:0042
Abyssus Elite (D.Va Edition)
1532:006A
Abyssus Essential
1532:006B
Abyssus V2
1532:005B
Atheris
1532:0062
Basilisk
1532:0064
Basilisk Essential
1532:0065
Basilisk Ultimate
1532:0088
1532:0086
Basilisk V2
1532:0085
Basilisk V3
1532:0099
Basilisk X HyperSpeed
1532:0083
DeathAdder 1800
1532:0038
DeathAdder 2000
1532:004F
DeathAdder 2013
1532:0037
DeathAdder 3.5G
1532:0016
DeathAdder 3.5G Black
1532:0029
DeathAdder 3500
1532:0054
DeathAdder Chroma
1532:0043
DeathAdder Elite
1532:005C
DeathAdder Essential
1532:006E
DeathAdder Essential (2021)
1532:0098
DeathAdder Essential (White Edition)
1532:0071
DeathAdder V2
1532:0084
DeathAdder V2 Mini
1532:008C
DeathAdder V2 Pro
1532:007C
1532:007D
DeathAdder V2 X HyperSpeed
1532:009C
DeathAdder V3 Pro
1532:00B6
1532:00B7
Diamondback Chroma
1532:004C
Imperator 2012
1532:002F
Lancehead
1532:0059
1532:005A
Lancehead Tournament Edition
1532:0060
Lancehead Wireless
1532:006F
1532:0070
Mamba
1532:0044
1532:0045
Mamba 2012
1532:0024
1532:0025
Mamba Elite
1532:006C
Mamba Tournament Edition
1532:0046
Mamba Wireless
1532:0072
1532:0073
Naga 2012
1532:002E
Naga 2014
1532:0040
Naga Chroma
1532:0053
Naga Epic Chroma
1532:003E
Naga Epic Chroma Dock
1532:003F
Naga Hex
1532:0041
Naga Hex (Red)
1532:0036
Naga Hex V2
1532:0050
Naga Left-Handed Edition 2020
1532:008D
Naga Pro
1532:008F
1532:0090
Naga Trinity
1532:0067
Naga X
1532:0096
Orochi
1532:0048
Orochi 2011
1532:0013
Orochi 2013
1532:0039
Orochi V2 (Bluetooth)
1532:0095
Orochi V2
1532:0094
Ouroboros
1532:0032
Pro Click
1532:0077
1532:0080
Taipan
1532:0034
Viper
1532:0078
Viper 8KHz
1532:0091
Viper Mini
1532:008A
Viper Ultimate
1532:007A
1532:007B
Viper V2 Pro
1532:00A5
1532:00A6

  Supported Mousemats


Firefly
1532:0C00
Firefly Hyperflux
1532:0068
Firefly V2
1532:0C04
Goliathus
1532:0C01
Goliathus Extended
1532:0C02

  Supported Keypads

A third party application is required for key rebinding, such as input-remapper.


Nostromo
1532:0111
Orbweaver
1532:0113
Orbweaver Chroma
1532:0207
Tartarus
1532:0201
Tartarus Chroma
1532:0208
Tartarus V2
1532:022B

  Supported Headphones

Only lighting features are supported. OpenRazer doesn't provide additional audio features.


Kraken 7.1
1532:0501
1532:0506
Kraken 7.1 Chroma
1532:0504
Kraken 7.1 V2
1532:0510
Kraken Kitty Edition
1532:0F19
Kraken Ultimate
1532:0527

  Other devices that work

Webcams with no lighting features are not supported. Try cameractrls to enable HDR and related functionality.


Base Station Chroma
1532:0F08
Base Station V2 Chroma
1532:0F20
Charging Pad Chroma
1532:0F26
Chroma Addressable RGB Controller
1532:0F1F
Chroma HDK
1532:0F09
Chroma Mug Holder
1532:0F07
Core
1532:0215
Mouse Bungee V3 Chroma
1532:0F1D
Mouse Dock
1532:007E
Nommo Chroma
1532:0517
Nommo Pro
1532:0518
Raptor 27
1532:0F12
Thunderbolt 4 Dock Chroma
1532:0F21

Device not listed?


Download

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 recommended so the user group is applied, and to load the OpenRazer driver.

After successful installation, pick an application that makes use of the driver.


Officially Supported

Packaged and supported by us!

 From AUR

Install openrazer-meta from the AUR using an AUR helper or by building the PKGBUILD directly.

After the drivers are installed, please restart the computer.

openSUSE Build Service

Instructions and downloadable builds for Debian are available here.

After the drivers are installed, please restart the computer.

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:

 sudo dnf install kernel-devel

Then, proceed to follow the installation instructions for Fedora.

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

After the drivers are installed, please restart the computer.

openSUSE Build Service

Instructions and downloadable builds for Mageia are available here.

After the drivers are installed, please restart the computer.

openSUSE Build Service

Instructions and downloadable builds for openSUSE are available here.

After the drivers are installed, please restart the computer.

  From the PPA via the Terminal

This will keep the drivers up-to-date when new versions are released.

If you're using elementaryOS, you'll need to install a prerequisite first:

 sudo apt install software-properties-gtk

To install the recommended stable builds:

 sudo add-apt-repository ppa:openrazer/stable

Alternately, if you wish to use the latest development builds, use daily instead -- use at your own risk!

 sudo add-apt-repository ppa:openrazer/daily

After adding the PPA, install the packages:

 sudo apt update
 sudo apt install openrazer-meta

NOTE: 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

After the drivers are installed, please restart the computer.

This PPA supports these versions:

  • Ubuntu 16.04 "Xenial" and newer
  • Linux Mint 18 "Sarah" and newer
  • elementaryOS 0.4 "Loki" and newer

Community Supported

Packaged and supported by the wider community.

Gentoo ebuild

To install:

 emerge -av --autounmask sys-apps/openrazer

After the drivers are installed, please restart the computer.

NixOS Module

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 plugdev group.
users.users.<name?>.extraGroups = [ "plugdev" ];

Rebuild your NixOS configuration:

 sudo nixos-rebuild switch

nix-shell

 nix-shell -p openrazer-daemon

Repository provided by moozhub

Please follow the instructions from this repository:

Using eopkg

To install:

 sudo eopkg install openrazer

After the drivers are installed, please restart the computer.

SlackBuilds.org

Packages are available at the following URLs:

For details on how to install, see the SlackBuilds.org FAQ.

After the drivers are installed, please restart the computer.

Void Linux

We have packages for Void Linux: openrazer-meta, openrazer-daemon, openrazer-driver-dkms, and python3-openrazer

To install:

 xbps-install -S openrazer-meta

After the drivers are installed, please restart the computer.

Applications

These projects integrate with OpenRazer:

Polychromatic

GUI (PyQt5)
Tray Applet
CLI

RazerGenie

GUI (Qt5)

Snake

GUI (Java)

razer-cli

CLI (Python)