How to Set Up Razer Devices on Linux for Lighting Effects and Other Configurations

Configure your Razer devices to set up lighting effects.
Warp Terminal

You have a shiny new Razer hardware, but you cannot find the Razer Synapse software for Linux. And you end up with no proper RGB sync and do not get to customize it. What do you do?

Well, for certain functionalities, like adding macros to your mouse, you will still need access to Razer Synapse (on Windows or macOS).

But, to tweak a few other options like macros for the keyboard, changing the DPI of your mouse, or lighting effects, you can easily set up your Razer peripherals on Linux.

razer basilisk v2
My Razer Basilisk V2 with lighting effect

Here are some pictures of both the mouse and the mouse pad. It’s the same setup but with different lighting schemes. Click on the images to see bigger images.

razer mouse pad lighting effect 3 com

Razer Basilisk is a good gaming mouse. If you want you can order it from Amazon or get it from your local store.

If you already own a Razer device, let me show the steps to configure it, just like what I did here.

Step 1: Install OpenRazer

OpenRazer is an open-source driver to make Razer hardware work on Linux. It supports several functionalities to customize and control your devices, including RGB mousemats.

While this is not an official driver for Linux, it works quite well for a wide range of devices.

It offers support for a variety of Linux distributions that include Solus, openSUSE, Fedora, Debian, Arch Linux, Ubuntu, and a few others.

Here, I will be focusing on the steps to install it on any Ubuntu-based distro, you may want to refer to the official instructions for other distros.

You need to install OpenRazer using a PPA on Ubuntu, here’s how to do that:

sudo apt install software-properties-gtk
sudo add-apt-repository ppa:openrazer/stable
sudo apt update
sudo apt install openrazer-meta

It also offers a daemon as well, you can choose to make it work, you will be adding your user to the plugdev group β€” which gives privileged access to the device:

sudo gpasswd -a $USER plugdev

I did not need to configure/add a daemon using the above command, but I can still use the devices just fine. The daemon mostly ensures that the driver stays active.

Step 2: Install a GUI to Manage and Tweak Options

Now that the driver has been installed, all you need is a graphical user interface (GUI) to help you customize your Razer hardware.

You can find a few options available out there, but I will recommend installing Polychromatic, which offers an attractive UI and works well as well.

polychromatic app

Polychromatic app is the closest I could recommend to Razer Synapse, and it works good.

For Ubuntu-based distros, all you need to do is install it using PPA:

sudo add-apt-repository ppa:polychromatic/stable
sudo apt update
sudo apt install polychromatic

You can find it listed in AUR for Arch Linux users. For more installation instructions, you can refer to the official download page.

While you will get a distinct set of options for various devices. Here, I tried changing the DPI, customizing the color cycle, and the polling rate of my Razer Basilisk v2 mouse, and it worked completely fine.

razer basilisk polychromatic
Customization options for a mouse

It also offers you the ability to easily restart or stop the daemon, change the applet icon, and perform advanced configuration options if you know what you want to do.

Alternatively, you can try RazerGenieSnake, or OpenRGB (meant for changing the colors) to tweak the mouse color or any other settings.

Wrapping Up

Now that you can easily customize your Razer hardware, hope you have fun!

While you may find some other options to configure your Razer devices, I did not find any other options that work very well.

If you have come across something that works and that deserves a mention here for all the Razer users, let me know in the comments below.

About the author
Ankush Das

Ankush Das

A passionate technophile who also happens to be a Computer Science graduate. You will usually see cats dancing to the beautiful tunes sung by him.

Become a Better Linux User

With the FOSS Weekly Newsletter, you learn useful Linux tips, discover applications, explore new distros and stay updated with the latest from Linux world


Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to It's FOSS.

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.