https://github.com/equk/blackwidow_macro

:penguin: enable macro keys on Razer BlackWidow keyboards
https://github.com/equk/blackwidow_macro

blackwidow libusb linux macro macros razer udev

Last synced: about 1 year ago
JSON representation

:penguin: enable macro keys on Razer BlackWidow keyboards

• Host: GitHub
• URL: https://github.com/equk/blackwidow_macro
• Owner: equk
• License: mit
• Created: 2016-01-22T13:28:31.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2020-06-07T22:24:48.000Z (about 6 years ago)
• Last Synced: 2025-03-24T03:23:40.557Z (over 1 year ago)
• Topics: blackwidow, libusb, linux, macro, macros, razer, udev
• Language: C
• Homepage:
• Size: 10.7 KB
• Stars: 12
• Watchers: 2
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![License](http://img.shields.io/:license-mit-blue.svg?style=flat)](http://badges.mit-license.org)

# blackwidow_macro

Razer BlackWidow Macro Keys Enabler

Copyright (C) 2016 B.Walden

This program sends a init packet used by Razer proprietary drivers to initialize the 'Macro' keys on Razer BlackWidow keyboards.

License: MIT (LICENSE file should be included with source)

Dependencies: [libusb](http://libusb.info/)

## Usage

    Razer BlackWidow Macro Keys v1.2

    Razer BlackWidow 2013 Device Found

    Sending data:

     00 00 00 00 00 02 00 04

     02 00 00 00 00 00 00 00

     00 00 00 00 00 00 00 00

     00 00 00 00 00 00 00 00

     00 00 00 00 00 00 00 00

     00 00 00 00 00 00 00 00

     00 00 00 00 00 00 00 00

     00 00 00 00 00 00 00 00

     00 00 00 00 00 00 00 00

     00 00 00 00 00 00 00 00

     00 00 00 00 00 00 00 00

     04 00

    Transmitted: 90

## Notes

BlackWidow Keyboards do not have any onboard memory for macros Razer use software for macro functionality in windows.

You can however use `xmacro` in linux

You can also use xmodmap or your WM to allocate functions to the macro key keycodes.

To find all connected Razer devices you can use: `lsusb -d 1532:`

## Extending

I have added a sample udev rule to `udev/99-bwidow.rules` which can be placed into `/usr/lib/udev/rules.d/99-bwidow.rules`

To install this you can do `make cpudev`

To remove you can do `make rmudev`

### Keycode Reference

    M1 = 191

    M2 = 192

    M3 = 193

    M4 = 194

    M5 = 195

### device id's included

    010D = "Razer BlackWidow Ultimate"

    010E = "Razer BlackWidow"

    011B = "Razer BlackWidow 2013"

If anyone wants me to add any more please tell me so I can add them in.

### todo

* ~~extract all known device id's of blackwidow keyboards from the Razer proprietary drivers~~

* ~~add more blackwidow device id's~~

### related references

* [Wireshark USB Capture Setup](https://wiki.wireshark.org/CaptureSetup/USB)

* [libusb on github](https://github.com/libusb/libusb)

* [libusb wiki on github](https://github.com/libusb/libusb/wiki)

### razer windows drivers

Device IDs taken from Razer BlackWidow drivers

    Razer010D.DeviceDesc     = "Razer BlackWidow Ultimate"

    Razer010E.DeviceDesc     = "Razer BlackWidow"

    Razer011B.DeviceDesc     = "Razer BlackWidow 2013"

    %Razer010D.DeviceDesc%=Razer, HID\Vid_1532&Pid_010D&MI_00

    %Razer010E.DeviceDesc%=Razer, HID\Vid_1532&Pid_010E&MI_00

    %Razer011B.DeviceDesc%=Razer, HID\Vid_1532&Pid_011B&MI_00