Difference between revisions of "Razer"

From ArchWiki
Jump to: navigation, search
m (Installation)
(13 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[Category:Mice (English)]]
+
[[Category:Mice]]
[[Category:HOWTOs (English)]]
+
[[bg:Razer]]
{{i18n|Razer}}
+
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.
  
= Background =
+
== Compatibility ==
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 =
+
'''razercfg''' lists the following mice models as stable:
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.
+
* 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
  
== Downloading ==
+
== Installation ==
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.
+
  
== Prerequesites ==
+
Download and install {{AUR|razercfg}} or {{AUR|razercfg-git}} for bleeding edge git releases from the [[AUR]].  
You need to install a few pacakges prior to this one.
+
# pacman -S cmake qt4 python python-qt4 libusb
+
  
== Compiling and installing ==
+
After installing with [https://wiki.archlinux.org/index.php/Pacman pacman] add the {{ic|razerd}} daemon
Extract the package then then compile and install it there following way:
+
  # systemctl enable razerd.service
$ cmake .
+
to start up at launch with.
$ 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/rd.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 ===
  
 
Retart the computer then enter:
 
Retart the computer then enter:
Line 44: Line 45:
  
 
To start the daemon, type:
 
To start the daemon, type:
  # /etc/rc.d/razerd start
+
  # systemctl start razerd.service
 
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.
  
= Bugs =
+
== 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.
 
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.

Revision as of 09:20, 17 February 2013

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

Download and install razercfgAUR or razercfg-gitAUR for bleeding edge git releases from the AUR.

After installing with pacman add the razerd daemon

# systemctl enable razerd.service

to start up at launch with.

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:

# systemctl start razerd.service

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.