No Description

Martchus eb9003c9b3 Merge pull request #4 from pjetherton/patch-1 8 months ago
.gitignore ed16865106 first commit 5 years ago
LICENSE ed16865106 first commit 5 years ago 739ab2523c Fix typo 2 years ago 0a76d3eec6 Fixes bug claiming interface 8 months ago
razer_blackwidow.rules ef7cfe38c5 Improve device detection 4 years ago

BlackWidow control

Python 3 script to enable macro keys of BlackWidow keyboard under GNU/Linux

It just enables the macro keys which can then be configured as hotkeys in your desktop environment. However, it does not enable the ability to record macros and to switch between different configurations like the Windows driver does.

For recording macros under X11 one might use xmacro or xdotool.

Supported devices

The script is known to work with the following BlackWidow editions:

  • regular edition (the ceapest one which has no background light)
  • the regular 2013 edition
  • BlackWidow Ultimate Stealth 2014

If you can confirm that those or other devices work or don't work, let me now by editing this file.


  • The script does not work with the 2016 editions (yet).
  • The script has been tested using the firmware update from Razer Synapse 2.0. Hence the script might not work when an older firmware version is used.


  • Pyusb is required to run the script.
  • Use -h for a list of available options.
  • To invoke the script automatically when the keyboard is plugged-in an udev rule can be added (see razer_blackwidow.rules).
  • The repository PKGBUILDs contains files for building an Arch Linux package.