Difference between revisions of "Razer"

From ArchWiki
Jump to: navigation, search
(Compiling and installing)
Line 2: Line 2:
 
[[Category:Mice (English)]]
 
[[Category:Mice (English)]]
  
= Background =
+
There is currently no official driver for the Razer gaming mice in Linux. However, Michael Buesch has created a tool called '''[http://www.bu3sch.de/cms/index.php/razer-nextgen-config-tool razercfg]''' to configure Razer mice under Linux.
There is currently no official driver for the Razer gaming mice in Linux. However, Michael Buesch has created a tool to configure varios Razer mice under Linux. Currently it lists Razer DeathAdder and Razer Krait as Stable, Razer Lachesis as experimental/missing features, Razer Copperhead and Razer Boomslang as not supported.
+
  
= Getting the tool working under Arch Linux =
+
= Compatibility =
While there are instructions in the README, I had to modify various things to get the driver to work properly. I am using the Razer Lachesis in my example.
+
  
== Downloading ==
+
'''razercfg''' lists the following mice models as stable:
Download the tool from the [http://www.bu3sch.de/joomla/index.php/razer-nextgen-config-tool the author's website]. The current latest version is 0.06.
+
* Razer DeathAdder Classic
 +
* Razer DeathAdder 3500 DPI
 +
* Razer DeathAdder Black Edition
 +
* Razer Krait
 +
* Razer Naga
 +
and the following as stable but missing minor features:
 +
* Razer Lachesis
 +
* Razer Copperhead
 +
* Razer Boomslang CE
  
== Prerequesites ==
+
= Installation =
You need to install a few packages prior to this one.
+
The tool can simply be downloaded and installed from the AUR [http://aur.archlinux.org/packages.php?ID=34000 here]; or may wish to download the [http://aur.archlinux.org/packages.php?ID=29738 git version] for bleeding-edge releases.
# pacman -S cmake qt4 python python-qt4 libusb
+
  
== Compiling and installing ==
+
After installing with [https://wiki.archlinux.org/index.php/Pacman pacman] you need to add the {{ic|razerd}} daemon to the DAEMONS array in {{ic|/etc/rc.conf}}
Extract the package then then compile and install it there following way:
+
$ cmake .
+
$ make
+
# make install
+
# ldconfig
+
  
Then, copy the daemon:
+
You also need to edit your {{ic|/etc/xorg.conf}} file to disable the current mouse settings. I just commented them out then set some defaults as suggested by the author:
# cp razerd.initscript /etc/rc.d/razerd
+
{{hc|/etc/xorg.conf|
 
+
== Before your restart ==
+
Before you restart, you need to edit your '''xorg.conf''' file to disable the current mouse settings. I just commented them out then set some defaults as suggested by the author:
+
 
  Section "InputDevice"
 
  Section "InputDevice"
     Identifier "Mouse"
+
     Identifier "Mouse"
     Driver "mouse"
+
     Driver "mouse"
     Option "Device" "/dev/input/mice"
+
     Option "Device" "/dev/input/mice"
  EndSection
+
  EndSection}}
It is important to only have "Mouse" and not "Mouse#" listed in '''xorg.conf'''.
+
It is important to only have {{ic|Mouse}} and not {{ic|Mouse#}} listed in {{ic|xorg.conf}}.
 +
 
 +
== For Python 3 users ==
 +
 
 +
If you have python 3 set as your default version then you will have to make a simple change to the source code of the two utilities. You can check by typing the following command {{bc|$ python -V}} If it returns python 2.X then you can skip this section.
  
Next, you need to copy the library as the installer puts it where Arch cannot find it. I simply did:
+
If it returns python 3.X then change the first line of '''both''' files {{ic|/usr/bin/razercfg}} and {{ic|/usr/bin/qrazercfg}} to the following: {{bc|#!/usr/bin/env python2}}
# cp /usr/local/lib/librazer.so /usr/lib/librazer.so
+
  
 
== Final touches ==
 
== Final touches ==
Line 46: Line 46:
 
If you did everything correctly, you shouldn't get errors.
 
If you did everything correctly, you shouldn't get errors.
  
== Using the Razer Configuration Tool ==
+
= Using the Razer Configuration Tool =
The tool is located under '''/usr/local/bin/razercfg''' and '''/usr/local/bin/qrazercfg'''. The second one is the GUI one. You can make a shortcut for it and put a fancy icon.
+
There are two commands you can use, one for the command line tool {{ic|razercfg}} or the Qt-based GUI tool {{ic|qrazercfg}}.
  
 
From the tool you can use the 5 profiles, change the DPI, change mouse frequency, enable and disable the scroll and logo lights and configure the buttons.
 
From the tool you can use the 5 profiles, change the DPI, change mouse frequency, enable and disable the scroll and logo lights and configure the buttons.

Revision as of 07:01, 27 December 2011

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

There is currently no official driver for the Razer gaming mice in Linux. However, Michael Buesch has created a tool called razercfg to configure Razer mice under Linux.

Compatibility

razercfg lists the following mice models as stable:

  • Razer DeathAdder Classic
  • Razer DeathAdder 3500 DPI
  • Razer DeathAdder Black Edition
  • Razer Krait
  • Razer Naga

and the following as stable but missing minor features:

  • Razer Lachesis
  • Razer Copperhead
  • Razer Boomslang CE

Installation

The tool can simply be downloaded and installed from the AUR here; or may wish to download the git version for bleeding-edge releases.

After installing with pacman you need to add the razerd daemon to the DAEMONS array in /etc/rc.conf

You also need to edit your /etc/xorg.conf file to disable the current mouse settings. I just commented them out then set some defaults as suggested by the author:

/etc/xorg.conf
 Section "InputDevice"
    Identifier  "Mouse"
    Driver  "mouse"
    Option  "Device" "/dev/input/mice"
 EndSection

It is important to only have Mouse and not Mouse# listed in xorg.conf.

For Python 3 users

If you have python 3 set as your default version then you will have to make a simple change to the source code of the two utilities. You can check by typing the following command
$ python -V
If it returns python 2.X then you can skip this section. If it returns python 3.X then change the first line of both files /usr/bin/razercfg and /usr/bin/qrazercfg to the following:
#!/usr/bin/env python2

Final touches

Retart the computer then enter:

# udevadm control --reload-rules

To start the daemon, type:

# /etc/rc.d/razerd start

If you did everything correctly, you shouldn't get errors.

Using the Razer Configuration Tool

There are two commands you can use, one for the command line tool razercfg or the Qt-based GUI tool qrazercfg.

From the tool you can use the 5 profiles, change the DPI, change mouse frequency, enable and disable the scroll and logo lights and configure the buttons.

Bugs

Everytime I restart, my Razer Lachesis is brought back to 500 DPI. Not that cruicial as I just open the Razer Configuration Tool and set it to 4000 DPI and all is good. I've e-mailed him on this issue and am waiting on a reply.