This mouse supports buttons mapping. Buttons can be mapped with:
some special actions,
mouse buttons,
multimedia keys,
and keyboard keys.
The general syntax for buttons mapping is the following:
buttons(layout=<LAYOUT>; button1=<mapping1>; buttonN=<mappingN>) +
Example:
rivalcfg --buttons "buttons(layout=QWERTY; button1=button1; button2=PlayPause; button3=disabled; button5=A; button6=DPI)" +
Arguments:
layout: The keyboard layout to use when papping the keys (see the “Mapping Keyboard Keys” section bellow).
layout
button1: The first button of the mouse.
button1
button2: The second button of the mouse.
button2
buttonN: The Nth button of the mouse (The number of available buttons depends of the mouse model).
buttonN
Note
All parameters are optional. If you do not define a mapping for a specific button, it will be reset to its default value.
You can also reset all buttons to their factory default by passing "default" as parameter:
"default"
rivalcfg --buttons default +
Warning
Be sure to map the mouse button button1 on some button, else you will not be able to click with the mouse!
The following special actions are available¹:
disabled: disable the button,
disabled
dpi: use this button to switch between DPI presets,
dpi
ScrollUp: simulate a scroll up (not available on all devices¹)
ScrollUp
ScrollDown: simulate a scroll down (not available on all devices¹)
ScrollDown
buttons(button4=disabled; button5=disabled; button6=DPI) +
¹ The ScrollUp and ScrollDown actions are not available on all devices.
Rival 300 / Rival: OK
Sensei [RAW]: Not supported
Mouse buttons can be mapped to any other mouse button.
For example, this swaps the 1 and 2 buttons of the mouse:
buttons(button1=button2; button2=button1) +
Mouse buttons can be mapped to multimedia keys. The following keys are available:
Mute: turn off the sound
Mute
Next: play next media
Next
PlayPause: toggle play / pause on the currently playing media
PlayPause
Previous: play the previous media
Previous
VolumeUp: increase the volume
VolumeUp
VolumeDown: decrease the volume
VolumeDown
buttons(button4=VolumeDown; button5=VolumeUp) +
Mouse buttons can be mapped to any keyboard key, using different layouts.
To select the desired layout, just use the layout parameter. If this +parameter is not specified, the QWERTY layout will be used by default.
QWERTY
Available layouts:
QWERTY (see available keys)
The available keys depend on the selected layout.
buttons(layout=QWERTY; button7=PageDown; button8=PageUp) +
Some characters like ; or = cannot be used as a key identifier as they +interfere with the buttons() syntax. For those keys, use one of the +available aliases, like semicolon (instead of ;) or equal +(instead of =).
;
=
buttons()
semicolon
equal
buttons(button4=semicolon; button5=equal) +
TODO
Check if the given udev rules are up to date.