OpenRazer | Open Source Drivers for GNU/Linux

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 224 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 75%

1532:02A5

BlackWidow V4 Mini Hyperspeed

1532:02B9
1532:02BA

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 14 (2025)

1532:02C5

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 Base (Late 2020)

1532:0268

Blade 15 Studio Edition (2019)

1532:024D

Blade 16 (2023)

1532:029F

Blade 16 (2025)

1532:02C6

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 18 (2024)

1532:02B8

Blade 18 (2025)

1532:02C7

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

Huntsman V3 Pro

1532:02A6

Huntsman V3 Pro TKL

1532:02A7

Ornata

1532:021F

Ornata Chroma

1532:021E

Ornata V2

1532:025D

Ornata V3

1532:028F
1532:02A1

Ornata V3 Tenkeyless

1532:02A3

Ornata V3 X

1532:02A2
1532:0294

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 35K

1532:00CB

Basilisk V3 Pro

1532:00AA
1532:00AB

Basilisk V3 Pro 35K

1532:00CC
1532:00CD

Basilisk V3 Pro 35K Phantom Green Edition

1532:00D6
1532:00D7

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 HyperSpeed

1532:00C4
1532:00C5

DeathAdder V3 Pro

1532:00C2
1532:00B6
1532:00B7
1532:00C3

DeathAdder V4 Pro

1532:00BE
1532:00BF

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

1532:0015

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 V2 Pro

1532:00A7
1532:00A8

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

Pro Click V2

1532:00D0
1532:00D1

Pro Click V2 Vertical Edition

1532:00C7
1532:00C8

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

Firefly V2 Pro

1532:0C08

Goliathus

1532:0C01

Goliathus Chroma 3XL

1532:0C06

Goliathus Extended

1532:0C02

Strider Chroma

1532:0C05

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 Kitty V2

1532:0560

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

Tomahawk ATX

1532:0F17

Device not listed?

Check unreleased changes

Search existing issues and pull requests

Request device support

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.

Debian

Starting with Debian 10, OpenRazer is available from the official repositories. However, you may need to add our repository and upgrade if your device was added in a newer version.

Instructions and downloadable builds for Debian are available from the openSUSE Build Service.

Fedora / Nobara

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 / Nobara 41 (and later), run the following:

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

sudo dnf install openrazer-meta

For Fedora Rawhide, run the following:

sudo dnf config-manager addrepo --from-repofile=https://download.opensuse.org/repositories/hardware:/razer/Fedora_Rawhide/hardware:razer.repo

sudo dnf install openrazer-meta

For Fedora / Nobara 40 (and earlier), run the following:

sudo dnf config-manager --add-repo https://openrazer.github.io/hardware:razer.repo

sudo dnf install openrazer-meta

Mageia

Instructions and downloadable builds for Mageia are available on openSUSE Build Service.

openSUSE

Instructions and downloadable builds for openSUSE are available on openSUSE Build Service. After installation, please enable dkms.service to ensure that the driver will also be built when installing kernel updates:

sudo systemctl enable --now dkms.service

Ubuntu / Linux Mint / elementaryOS / Pop!_OS / Zorin OS

Starting with 20.04, OpenRazer is available from the official repositories. However, you may need to add our repository and upgrade 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.

Alpine Linux

Packages are available from the community repositories.

doas apk add openrazer openrazer-src

The kernel modules are built via akms.

Arch Linux / Manjaro

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.

Gentoo

An ebuild is available, to install:

emerge -av --autounmask sys-apps/openrazer

NixOS

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

SteamOS

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.