2016-07-08 18:00:15 +02:00
|
|
|
# BlackWidow control
|
|
|
|
Python 3 script to enable macro keys of BlackWidow keyboard under GNU/Linux
|
2015-07-31 22:16:11 +02:00
|
|
|
|
2016-10-08 18:06:41 +02:00
|
|
|
It just enables the macro keys which can then be configured as hotkeys in your desktop environment.
|
2016-10-08 18:27:17 +02:00
|
|
|
However, it does not enable the ability to record macros and to switch between different configurations
|
2016-10-08 18:06:41 +02:00
|
|
|
like the Windows driver does.
|
2015-09-17 13:41:28 +02:00
|
|
|
|
2016-10-08 18:27:17 +02:00
|
|
|
For recording macros under X11 one might use [xmacro](http://download.sarine.nl/xmacro/Description.html)
|
|
|
|
or [xdotool](http://www.semicomplete.com/projects/xdotool/).
|
|
|
|
|
2016-07-08 18:00:15 +02:00
|
|
|
## Supported devices
|
2018-10-07 18:37:57 +02:00
|
|
|
The script is known to work with the following BlackWidow editions:
|
2016-07-08 18:00:15 +02:00
|
|
|
- regular edition (the ceapest one which has no background light)
|
|
|
|
- the regular 2013 edition
|
2016-10-11 12:45:11 +02:00
|
|
|
- BlackWidow Ultimate Stealth 2014
|
2020-05-04 17:09:26 +02:00
|
|
|
- BlackWidow Ultimate 2012
|
2021-11-30 14:04:58 +01:00
|
|
|
- BlackWidow Chroma V2
|
2016-10-08 18:06:41 +02:00
|
|
|
|
|
|
|
If you can confirm that those or other devices work or don't work, let me now by editing this file.
|
|
|
|
|
2016-07-08 18:00:15 +02:00
|
|
|
### Notes
|
|
|
|
- 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.
|
2015-09-17 13:41:28 +02:00
|
|
|
|
2015-07-31 22:21:39 +02:00
|
|
|
## Instructions
|
2016-07-08 18:00:15 +02:00
|
|
|
- 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```).
|
2021-05-03 13:37:51 +02:00
|
|
|
|
|
|
|
## Packages
|
|
|
|
- Arch Linux: [AUR](https://aur.archlinux.org/packages/blackwidowcontrol),
|
|
|
|
[PKGBUILDs](https://github.com/Martchus/PKGBUILDs), [binary repository](https://martchus.no-ip.biz/repo/arch/ownstuff)
|
|
|
|
- openSUSE and Fedora:
|
|
|
|
[OBS](https://software.opensuse.org//download.html?project=home%3Amkittler&package=blackwidowcontrol)
|