You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

35 lines
1.6 KiB

6 years ago
3 years ago
  1. # BlackWidow control
  2. Python 3 script to enable macro keys of BlackWidow keyboard under GNU/Linux
  3. It just enables the macro keys which can then be configured as hotkeys in your desktop environment.
  4. However, it does not enable the ability to record macros and to switch between different configurations
  5. like the Windows driver does.
  6. For recording macros under X11 one might use [xmacro](http://download.sarine.nl/xmacro/Description.html)
  7. or [xdotool](http://www.semicomplete.com/projects/xdotool/).
  8. ## Supported devices
  9. The script is known to work with the following BlackWidow editions:
  10. - regular edition (the ceapest one which has no background light)
  11. - the regular 2013 edition
  12. - BlackWidow Ultimate Stealth 2014
  13. - BlackWidow Ultimate 2012
  14. If you can confirm that those or other devices work or don't work, let me now by editing this file.
  15. ### Notes
  16. - The script does not work with the 2016 editions (yet).
  17. - The script has been tested using the firmware update from Razer Synapse 2.0.
  18. Hence the script might not work when an older firmware version is used.
  19. ## Instructions
  20. - Pyusb is required to run the script.
  21. - Use ```-h``` for a list of available options.
  22. - To invoke the script automatically when the keyboard is plugged-in an udev
  23. rule can be added (see ```razer_blackwidow.rules```).
  24. ## Packages
  25. - Arch Linux: [AUR](https://aur.archlinux.org/packages/blackwidowcontrol),
  26. [PKGBUILDs](https://github.com/Martchus/PKGBUILDs), [binary repository](https://martchus.no-ip.biz/repo/arch/ownstuff)
  27. - openSUSE and Fedora:
  28. [OBS](https://software.opensuse.org//download.html?project=home%3Amkittler&package=blackwidowcontrol)