What is OpenRazer?

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

Linux Kernel Module

Written in C and configured to rebuild on kernel updates using DKMS

Daemon

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

Python Library

For integration with scripts and applications ↓

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. 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.

Devices

Originally written for the BlackWidow Chroma, the driver is now compatible with 201 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
1532:025C
BlackWidow V3 Tenkeyless
1532:0A24
BlackWidow V4
1532:0287
BlackWidow V4 Pro
1532:028D
BlackWidow V4 X
1532:0293
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 14 (2022)
1532:028C
Blade 14 (2023)
1532:029D
Blade 14 (2024)
1532:02B6
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 (2023)
1532:029E
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 (2022)
1532:027A
Blade 15 Base (Early 2020)
1532:0255
Blade 15 Base (Early 2021)
1532:026F
Blade 15 Studio Edition (2019)
1532:024D
Blade 16 (2023)
1532:029F
Blade 17 (2022)
1532:028B
Blade 17 Pro (Early 2021)
1532:026E
Blade 17 Pro (Mid 2021)
1532:0279
Blade 18 (2023)
1532:02A0
Blade Advanced (Late 2019)
1532:024B
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 V2 Pro
1532:0292
1532:0290
DeathStalker V2 Pro TKL
1532:0298
1532:0296
Deathstalker (Essential)
1532:0118
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
Ornata V3
1532:02A1
Ornata V3 Tenkeyless
1532:02A3
Ornata V3 X
1532:0294
1532:02A2

  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 V3 Pro
1532:00AA
1532:00AB
Basilisk V3 X HyperSpeed
1532:00B9
Basilisk X HyperSpeed
1532:0083
Cobra
1532:00A3
Cobra Pro
1532:00AF
1532:00B0
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 Lite
1532:00A1
DeathAdder V2 Mini
1532:008C
DeathAdder V2 Pro
1532:007C
1532:007D
DeathAdder V2 X HyperSpeed
1532:009C
DeathAdder V3
1532:00B2
DeathAdder V3 Pro
1532:00B6
1532:00C2
1532:00B7
1532:00C3
Diamondback Chroma
1532:004C
HyperPolling Wireless Dongle
1532:00B3
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
1532:001F
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 V2 HyperSpeed
1532:00B4
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
Pro Click Mini
1532:009A
Taipan
1532:0034
Viper
1532:0078
Viper 8KHz
1532:0091
Viper Mini
1532:008A
Viper Mini Signature Edition
1532:009E
1532:009F
Viper Ultimate
1532:007A
1532:007B
Viper V2 Pro
1532:00A5
1532:00A6
Viper V3 HyperSpeed
1532:00B8
Viper V3 Pro
1532:00C0
1532:00C1

  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:0506
1532:0501
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
Core X Chroma
1532:0F1A
Laptop Stand Chroma
1532:0F0D
Laptop Stand Chroma V2
1532:0F2B
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 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.


Officially Supported

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.


Community Supported

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/

An eopkg is available, to install:

sudo eopkg install openrazer

Void Linux provides these packages:

To install:

xbps-install -S openrazer-meta

Applications

These projects integrate with OpenRazer:

Polychromatic

Python, Qt 6
Tray Applet

Snake

Java