Find a file
2020-02-08 00:38:18 +01:00
include Add fire button and investigate macro repetition 2019-12-13 03:02:46 +01:00
example.ini Add fire button and investigate macro repetition 2019-12-13 03:02:46 +01:00
example.macro Add support for macros 2019-12-08 01:52:41 +01:00
keymap.md Update keymap.md 2020-02-08 00:38:18 +01:00
LICENSE Initial commit 2019-11-09 01:09:17 +01:00
makefile Fix and update makefile 2019-11-30 00:15:54 +01:00
mouse_m908.cpp Add fire button and investigate macro repetition 2019-12-13 03:02:46 +01:00
mouse_m908.rules Add files via upload 2019-11-09 01:10:30 +01:00
README.md Add fire button and investigate macro repetition 2019-12-13 03:02:46 +01:00

mouse_m908

Control the Redragon M908 Impact gaming mouse from Linux

Status

All settings from the official software are implemented, except repeating macros, which seems to be broken in the official software and is therefore currently disabled in this program. As a result there will be no changes to this program, unless I overlooked some features or find a bug.

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