Difference between revisions of "Razer peripherals"

From ArchWiki
Jump to: navigation, search
m (Corrected dead URL http://www.bu3sch.de/cms/index.php/razer-nextgen-config-tool to http://bues.ch/cms/hacking/razercfg.html)
m (add ja link)
 
(104 intermediate revisions by 35 users not shown)
Line 1: Line 1:
 
[[Category:Mice]]
 
[[Category:Mice]]
[[bg:Razer]]
+
[[Category:Keyboards]]
There is currently no official driver for the Razer gaming mice in Linux. However, Michael Buesch has created a tool called '''[http://bues.ch/cms/hacking/razercfg.html razercfg]''' to configure Razer mice under Linux.
+
[[ja:Razer]]
 +
{{Poor writing|Various style issues, structure lacking}}
  
== Compatibility ==
+
{{Note|This page refers to Razer's mice and keyboards. If you were looking for the laptop, see [[Razer Blade]].}}
 +
 
 +
There are currently no official drivers for any Razer peripherals in Linux. However, Michael Buesch has created a tool called [http://bues.ch/cms/hacking/razercfg.html razercfg] to configure Razer mice under Linux. There also exist scripts to enable macro keys of Razer keyboards.
 +
 
 +
Another package, {{AUR|openrazer-meta}} can be used to enable Razer support along with {{AUR|polychromatic}} or {{AUR|razergenie}} for GUI configuration. Supported devices are [https://openrazer.github.io/#devices listed here]
 +
 
 +
== razercfg ==
 +
 
 +
=== Compatibility ===
 +
 
 +
''razercfg'' lists the following mice models as stable:
  
'''razercfg''' lists the following mice models as stable:
 
 
* Razer DeathAdder Classic
 
* Razer DeathAdder Classic
 
* Razer DeathAdder 3500 DPI
 
* Razer DeathAdder 3500 DPI
 
* Razer DeathAdder Black Edition
 
* Razer DeathAdder Black Edition
 +
* Razer DeathAdder 2013
 +
* Razer DeathAdder Chroma
 
* Razer Krait
 
* Razer Krait
* Razer Naga
+
* Razer Naga Classic
and the following as stable but missing minor features:
+
* Razer Naga 2012
 +
* Razer Naga 2014
 +
* Razer Naga Hex
 +
* Razer Taipan
 +
 
 +
And the following as stable but missing minor features:
 +
 
 
* Razer Lachesis
 
* Razer Lachesis
 
* Razer Copperhead
 
* Razer Copperhead
 
* Razer Boomslang CE
 
* Razer Boomslang CE
  
== Installation ==
+
=== Installation ===
  
 
Download and install {{AUR|razercfg}} or {{AUR|razercfg-git}} for bleeding edge git releases from the [[AUR]].  
 
Download and install {{AUR|razercfg}} or {{AUR|razercfg-git}} for bleeding edge git releases from the [[AUR]].  
  
After installing with [https://wiki.archlinux.org/index.php/Pacman pacman] add the {{ic|razerd}} daemon
+
You also need to edit your {{ic|/etc/X11/xorg.conf}} file to disable the current mouse settings by commenting them out as in the following example, where also some defaults are set as suggested by the author:
# systemctl enable razerd.service
 
to start up at launch with.
 
  
You also need to edit your {{ic|/etc/X11/xorg.conf}} file to disable the current mouse settings. I just commented them out then set some defaults as suggested by the author:
+
{{hc|/etc/X11/xorg.conf|
{{hc|/etc/xorg.conf|
 
 
  Section "InputDevice"
 
  Section "InputDevice"
 
     Identifier  "Mouse"
 
     Identifier  "Mouse"
Line 31: Line 46:
 
     Option  "Device" "/dev/input/mice"
 
     Option  "Device" "/dev/input/mice"
 
  EndSection}}
 
  EndSection}}
 +
 
It is important to only have {{ic|Mouse}} and not {{ic|Mouse#}} listed in {{ic|xorg.conf}}.
 
It is important to only have {{ic|Mouse}} and not {{ic|Mouse#}} listed in {{ic|xorg.conf}}.
  
=== For Python 3 users ===
+
{{Accuracy|Why reboot?}}
  
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.
+
Restart the computer, then enter:
  
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}}
+
# udevadm control --reload-rules
  
=== Final touches ===
+
Then [[start]] the {{ic|razerd}} daemon and possibly enable it.
  
Retart the computer then enter:
+
=== Using the Razer Configuration Tool ===
# udevadm control --reload-rules
 
  
To start the daemon, type:
+
{{Accuracy|Button configuration reported to not work|Talk:Razer#Button configuration in razercfg or qrazercfg}}
# 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''.
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.
 +
 +
If the colors reset on reboot edit the config file directly and test with another reboot:
 +
 +
{{hc|/etc/razer.conf|
 +
# Configure LEDs
 +
led<nowiki>=</nowiki>1:GlowingLogo:on
 +
led<nowiki>=</nowiki>1:Scrollwheel:on
 +
mode<nowiki>=</nowiki>1:Scrollwheel:static
 +
color<nowiki>=</nowiki>1:Scrollwheel:0000FF
 +
mode<nowiki>=</nowiki>1:GlowingLogo:static
 +
color<nowiki>=</nowiki>1:GlowingLogo:FFFFFF
 +
}}
 +
 +
"static" can probably be changed to spectrum or breathing, and mode/color lines can be removed if led is set to "off".
 +
 +
== OpenRazer ==
 +
 +
=== Compatibility ===
 +
 +
==== Keyboards ====
 +
* Razer BlackWidow Ultimate 2012
 +
* Razer BlackWidow Classic (Alternate)
 +
* Razer Anansi
 +
* Razer BlackWidow Ultimate 2013
 +
* Razer BlackWidow Classic
 +
* Razer DeathStalker Expert
 +
* Razer BlackWidow Chroma
 +
* Razer DeathStalker Chroma
 +
* Razer Blade Stealth
 +
* Razer Orbweaver Chroma
 +
* Razer BlackWidow Tournament Edition Chroma
 +
* Razer Blade QHD
 +
* Razer Blade Pro (Late 2016)
 +
* Razer BlackWidow Chroma (Overwatch)
 +
* Razer BlackWidow Ultimate 2016
 +
* Razer BlackWidow X Chroma
 +
* Razer BlackWidow X Ultimate
 +
* Razer BlackWidow X Tournament Edition Chroma
 +
* Razer Ornata Chroma
 +
* Razer Ornata
 +
* Razer Blade Stealth (Late 2016)
 +
* Razer BlackWidow Chroma V2
 +
* Razer Blade (Late 2016)
 +
* Razer Blade Stealth (Mid 2017)
 +
 +
==== Mice ====
 +
* Razer Orochi 2011           
 +
* Razer Mamba 2012 (Wired)     
 +
* Razer Mamba 2012 (Wireless) 
 +
* Razer Imperator 2012         
 +
* Razer Ouroboros 2012         
 +
* Razer Taipan                 
 +
* Razer Naga Hex (Red)         
 +
* Razer Orochi 2013           
 +
* Razer Naga 2014             
 +
* Razer Naga Hex               
 +
* Razer Abyssus 2014           
 +
* Razer DeathAdder Chroma     
 +
* Razer Mamba (Wired)         
 +
* Razer Mamba (Wireless)       
 +
* Razer Mamba Tournament Edition
 +
* Razer Orochi (Wired)         
 +
* Razer Diamondback Chroma     
 +
* Razer Naga Hex V2           
 +
* Razer Naga Chroma           
 +
* Razer Abyssus V2             
 +
* Razer DeathAdder Elite       
 +
 +
==== Mousemats ====
 +
* Razer Firefly
 +
 +
==== Headsets ====
 +
* Razer Kraken 7.1 Classic
 +
* Razer Kraken 7.1 Chroma
 +
* Razer Kraken 7.1 V2
 +
 +
==== Other devices ====
 +
* Razer Nostromo
 +
* Razer Orbweaver
 +
* Razer Tartarus
 +
* Razer Tartarus Chroma
 +
* Razer Core
 +
* Razer Chroma Mug Holder
 +
 +
=== Installation ===
 +
 +
[[Install]] the {{AUR|openrazer-meta}} package. Don't forget to add your current user to the group {{ic|plugdev}} with the command {{ic|sudo gpasswd -a $USER plugdev}} and logging out and back in.
 +
 +
=== How to use ===
 +
 +
The recommended way is to use a graphical front-end for interfacing with the drivers.
 +
 +
* {{AUR|polychromatic}}: A WebKit-based front-end featuring profiles
 +
* {{AUR|razergenie}}: A Qt-based front-end
 +
* {{AUR|razercommander}}: A GTK-based front-end
 +
 +
=== Troubleshooting ===
 +
 +
Visit the [https://github.com/openrazer/openrazer/wiki/Troubleshooting Troubleshooting page] in the OpenRazer wiki.
 +
 +
== Razer keyboards ==
 +
There are currently two Python scripts available to enable macro keys under Linux:
 +
=== Blackwidow Control ===
 +
====Features====
 +
* confirmed to work with regular BlackWidow, BlackWidow 2013 and BlackWidow Ultimate Stealth 2014
 +
* should also work with BlackWidow Ultimate, BlackWidow Ultimate 2013 and BlackWidow 2014
 +
* does not work with BlackWidow (Ultimate) 2016 yet
 +
* uses Python 3
 +
* allows to control the status of the LED
 +
* contains a file with udev rule so macro keys will be enabled automatically when the keyboard is plugged in
 +
 +
==== How to Use ====
 +
Install it from AUR {{AUR|blackwidowcontrol}}
 +
After install run as root
 +
$ blackwidowcontrol -i
 +
Then use the shortcut utility of your Desktop Enviroment to map the keys
 +
 +
=== Blackwidow macro scripts ===
 +
==== Features ====
 +
* Works with BlackWidow Ultimate and Stealth 2013 (unknown whether it works with other versions)
 +
* Uses Python 2
 +
* Bundles scripts to create and execute macros
 +
 +
== Troubleshooting ==
 +
 +
=== Mouse randomly stops working ===
 +
 +
{{Note|This is tested on [[ASUS N550JV]] using mouse '''Razer Orochi 2013'''. Laptop probably has faulty charging port and therefore it sometimes directly affects connected mouse USB port and causes similar issues.}}
 +
 +
If your razer mouse stops working after some time, however, led flashes or lights up, but reboot and re-plugging does not help, try the following commands.
 +
 +
Unload {{ic|ehci_pci}} and {{ic|ehci_hcd}} modules:
 +
 +
# rmmod ehci_pci
 +
# rmmod ehci_hcd
 +
 +
Disconnect the mouse, wait a few seconds and run the following commands to load modules back:
 +
 +
# modprobe ehci_hcd
 +
# modprobe ehci_pci
 +
 +
Connect the mouse and it should be working.

Latest revision as of 11:43, 5 September 2017

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements.Tango-edit-clear.png

Reason: Various style issues, structure lacking (Discuss in Talk:Razer peripherals#)
Note: This page refers to Razer's mice and keyboards. If you were looking for the laptop, see Razer Blade.

There are currently no official drivers for any Razer peripherals in Linux. However, Michael Buesch has created a tool called razercfg to configure Razer mice under Linux. There also exist scripts to enable macro keys of Razer keyboards.

Another package, openrazer-metaAUR can be used to enable Razer support along with polychromaticAUR or razergenieAUR for GUI configuration. Supported devices are listed here

razercfg

Compatibility

razercfg lists the following mice models as stable:

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

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.

You also need to edit your /etc/X11/xorg.conf file to disable the current mouse settings by commenting them out as in the following example, where also some defaults are set as suggested by the author:

/etc/X11/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.

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: Why reboot? (Discuss in Talk:Razer peripherals#)

Restart the computer, then enter:

# udevadm control --reload-rules

Then start the razerd daemon and possibly enable it.

Using the Razer Configuration Tool

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: Button configuration reported to not work (Discuss in Talk:Razer#Button configuration in razercfg or qrazercfg)

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.

If the colors reset on reboot edit the config file directly and test with another reboot:

/etc/razer.conf
# Configure LEDs
led=1:GlowingLogo:on
led=1:Scrollwheel:on
mode=1:Scrollwheel:static
color=1:Scrollwheel:0000FF
mode=1:GlowingLogo:static
color=1:GlowingLogo:FFFFFF

"static" can probably be changed to spectrum or breathing, and mode/color lines can be removed if led is set to "off".

OpenRazer

Compatibility

Keyboards

  • Razer BlackWidow Ultimate 2012
  • Razer BlackWidow Classic (Alternate)
  • Razer Anansi
  • Razer BlackWidow Ultimate 2013
  • Razer BlackWidow Classic
  • Razer DeathStalker Expert
  • Razer BlackWidow Chroma
  • Razer DeathStalker Chroma
  • Razer Blade Stealth
  • Razer Orbweaver Chroma
  • Razer BlackWidow Tournament Edition Chroma
  • Razer Blade QHD
  • Razer Blade Pro (Late 2016)
  • Razer BlackWidow Chroma (Overwatch)
  • Razer BlackWidow Ultimate 2016
  • Razer BlackWidow X Chroma
  • Razer BlackWidow X Ultimate
  • Razer BlackWidow X Tournament Edition Chroma
  • Razer Ornata Chroma
  • Razer Ornata
  • Razer Blade Stealth (Late 2016)
  • Razer BlackWidow Chroma V2
  • Razer Blade (Late 2016)
  • Razer Blade Stealth (Mid 2017)

Mice

  • Razer Orochi 2011
  • Razer Mamba 2012 (Wired)
  • Razer Mamba 2012 (Wireless)
  • Razer Imperator 2012
  • Razer Ouroboros 2012
  • Razer Taipan
  • Razer Naga Hex (Red)
  • Razer Orochi 2013
  • Razer Naga 2014
  • Razer Naga Hex
  • Razer Abyssus 2014
  • Razer DeathAdder Chroma
  • Razer Mamba (Wired)
  • Razer Mamba (Wireless)
  • Razer Mamba Tournament Edition
  • Razer Orochi (Wired)
  • Razer Diamondback Chroma
  • Razer Naga Hex V2
  • Razer Naga Chroma
  • Razer Abyssus V2
  • Razer DeathAdder Elite

Mousemats

  • Razer Firefly

Headsets

  • Razer Kraken 7.1 Classic
  • Razer Kraken 7.1 Chroma
  • Razer Kraken 7.1 V2

Other devices

  • Razer Nostromo
  • Razer Orbweaver
  • Razer Tartarus
  • Razer Tartarus Chroma
  • Razer Core
  • Razer Chroma Mug Holder

Installation

Install the openrazer-metaAUR package. Don't forget to add your current user to the group plugdev with the command sudo gpasswd -a $USER plugdev and logging out and back in.

How to use

The recommended way is to use a graphical front-end for interfacing with the drivers.

Troubleshooting

Visit the Troubleshooting page in the OpenRazer wiki.

Razer keyboards

There are currently two Python scripts available to enable macro keys under Linux:

Blackwidow Control

Features

  • confirmed to work with regular BlackWidow, BlackWidow 2013 and BlackWidow Ultimate Stealth 2014
  • should also work with BlackWidow Ultimate, BlackWidow Ultimate 2013 and BlackWidow 2014
  • does not work with BlackWidow (Ultimate) 2016 yet
  • uses Python 3
  • allows to control the status of the LED
  • contains a file with udev rule so macro keys will be enabled automatically when the keyboard is plugged in

How to Use

Install it from AUR blackwidowcontrolAUR After install run as root

$ blackwidowcontrol -i

Then use the shortcut utility of your Desktop Enviroment to map the keys

Blackwidow macro scripts

Features

  • Works with BlackWidow Ultimate and Stealth 2013 (unknown whether it works with other versions)
  • Uses Python 2
  • Bundles scripts to create and execute macros

Troubleshooting

Mouse randomly stops working

Note: This is tested on ASUS N550JV using mouse Razer Orochi 2013. Laptop probably has faulty charging port and therefore it sometimes directly affects connected mouse USB port and causes similar issues.

If your razer mouse stops working after some time, however, led flashes or lights up, but reboot and re-plugging does not help, try the following commands.

Unload ehci_pci and ehci_hcd modules:

# rmmod ehci_pci
# rmmod ehci_hcd

Disconnect the mouse, wait a few seconds and run the following commands to load modules back:

# modprobe ehci_hcd
# modprobe ehci_pci

Connect the mouse and it should be working.