Gadget Tools: Configure Razer Mice In Linux With Razercfg Ubuntu PPA

Monday, October 31, 2016

Configure Razer Mice In Linux With Razercfg Ubuntu PPA

Razer Synapse, the official Razer configuration utility, doesnt work on Linux however, theres a tool called Razercfg that allows configuring some of the Razer mice settings under Linux.

The application only includes options that are supported by the mouse hardware, like changing the DPI, scan frequency (polling rate) and led colors. So for instance if the hardware doesnt support button remapping, Razercfg wont offer this option. That also means that Razercfg doesnt support macros.

Razercfg also allows saving and easily switching between profiles (Desktop, FPS gaming, RPG gaming, etc.).

The latest stable Razercfg doesnt ship with a tray applet / AppIndicator, though such a feature should be added in the next release (0.34), and youll be able to use it to quickly switch between profiles.

Razercfg supports the following devices:

Razer DeathAdder Classic
Razer DeathAdder 3500 DPI
Razer DeathAdder Black Edition
Razer DeathAdder 2013
Razer DeathAdder Chroma
Razer Krait
Razer Lachesis Classic
Razer Naga Classic mouse
Razer Naga 2012 mouse
Razer Naga 2014 mouse
Razer Naga Hex mouse
Razer Taipan mouse

The following mice are listed as stable, but missing minor features:

Razer Boomslang CE
Razer Copperhead
Razer Lachesis Classic

For a complete list of hardware features for each mouse, see the Razercfg homepage.

I also managed to add basic support for Razer Ouroboros mice (for both wired and wireless modes), based on this bug report, by using the Taipan code as a base (only basic features: enable/disable the leds and change the DPI and scan frequency). This is available if you use the packages available in the main WebUpd8 PPA or by downloading the Debian packaging (youll find the patch in the debian/patch folder).

Dont report bugs related to the Ouroboros on the Razercfg GitHub page since the app doesnt officially support it yet.

Install Razercfg in Ubuntu

Note that I only tested the packages in Ubuntu 16.04, which uses systemd, so Im not sure if it will work in Ubuntu 14.04.

Razercfg is available in the main WebUpd8 PPA, for Ubuntu 16.04, 15.10, 15.04 and 14.04. Add the PPA and install the application using the following commands:

sudo add-apt-repository ppa:nilarimogard/webupd8
sudo apt update
sudo apt install razercfg

Adding the PPA is not required (but you wont receive any updates) - you can download the deb from HERE.

If the application doesnt detect your mouse (and the device is listed as supported), try restarting the system and also see the first note below.

Important:

if your system has an xorg.conf file (/etc/X11/xorg.conf), youll need to make sure it doesnt specify a device (you can comment out the "Device" section) or configure it to use a generic device. The Razercfg GitHub page explains this in detail;
if the settings are not saved between system restarts, you can edit the /etc/razer.conf configuration file to specify various options and initial hardware configuration settings.

For other Linux distributions, see the Razercfg GitHub page.

Also see: How To Change The Mouse Scroll Wheel Speed In Linux Using imwheel.

Go to link Download