mouse_m908/README.md

mouse_m908

Control the Redragon M908 Impact gaming mouse from Linux

Installing

• Install the dependencies:
  • libusb
  • boost
• Clone this repo and run sudo make install
• Restart to get userspace access to the mouse via the installed udev rule
• Upgrade an existing installation with sudo make upgrade
• Uninstall with sudo make uninstall

Usage

The settings are stored in a file and applied all at once (except macros, see below). See example.ini and keymap.md

• Apply the example configuration: mouse_m908 -c example.ini
• Set active profile to number 3: mouse_m908 -p 3
• Get usage info: mouse_m908 -h
• Send macro example.macro to slot 1: mouse_m908 -m example.macro -n 1

Macros

There is space for 15 macros on the mouse, these are shared over all profiles. Each macro can hold up to 34 actions. To set a macro to a specific button:

1. Create a file containing the macro actions
2. Add macro⟨N⟩ to the button mapping configuration to set a button to the ⟨N⟩th macro
3. Apply the configuration: mouse_m908 -c ⟨config.ini⟩
4. Apply the specific macro: mouse_m908 -m ⟨macrofile⟩ -n ⟨N⟩

Macro file

Each line contains an action and a parameter separated by a tab. Supported actions are:

• down ⟨key⟩
• up ⟨key⟩
• delay ⟨1-255⟩

example.macro for an example, keymap.md section Keyboard keys/Keys for a list of recognized Keys. Supported mousebuttons (up and down):

• mouse_left
• mouse_right
• mouse_middle

TODO

Button remapping is not (yet) fully supported: macros and keyboard keys aren't implemented. Macros are currently missing some features:

• delay between keys
• mousebuttons