SteelSeries Sensei [RAW]

Supported Models

SteelSeries Sensei [RAW]	1038:1369
SteelSeries Sensei [RAW] Diablo III Edition	1038:1362
SteelSeries Sensei [RAW] Guild Wars 2 Edition	1038:136d
SteelSeries Sensei [RAW] CoD Black Ops II Edition	1038:136f
SteelSeries Sensei [RAW] World of Tanks Edition	1038:1380
SteelSeries Sensei [RAW] Heroes of the Storm Edition	1038:1390

Command-Line Usage

usage: rivalcfg [-h] [--list] [--version] [--no-save] [--update-udev]
                [--print-udev] [--print-debug] [-s SENSITIVITY1]
                [-S SENSITIVITY2] [-p POLLING_RATE] [-l LED_BRIGHTNESS]
                [-e LIGHT_EFFECT] [-b BUTTONS_MAPPING] [-r]

options:
  -h, --help            show this help message and exit
  --list                List supported devices and exit
  --version             show program's version number and exit
  --no-save             Do not persist settings in the internal device memory
  --update-udev         Updates udev rules (Linux only, requires to be run as
                        root)
  --print-udev          Prints udev rules and exit
  --print-debug         Prints debug information and exit

SteelSeries Sensei [RAW] Options:
  -s SENSITIVITY1, --sensitivity1 SENSITIVITY1
                        Set sensitivity preset 1 (DPI) (from 90 to 5670,
                        default: 1620)
  -S SENSITIVITY2, --sensitivity2 SENSITIVITY2
                        Set sensitivity preset 2 (DPI) (from 90 to 5670,
                        default: 3240)
  -p POLLING_RATE, --polling-rate POLLING_RATE
                        Set polling rate (Hz) (values: 125, 250, 500, 1000,
                        default: 1000)
  -l LED_BRIGHTNESS, --led-brightness LED_BRIGHTNESS
                        Set the brightness of the LEDs (values: off, low,
                        medium, high, default: off)
  -e LIGHT_EFFECT, --light-effect LIGHT_EFFECT
                        Set the light effect (values: steady, breath, trigger,
                        1, 2, 3, 4, default: breath)
  -b BUTTONS_MAPPING, --buttons BUTTONS_MAPPING
                        Set the mapping of the buttons (default:
                        buttons(button1=button1; button2=button2;
                        button3=button3; button4=button4; button5=button5;
                        button6=PageDown; button7=PageUp; button8=dpi;
                        layout=qwerty))
  -r, --reset           Reset all settings to their factory default

Please report any bug on Github: https://github.com/flozz/rivalcfg/issues

Buttons

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).
button1: The first button of the mouse.
button2: The second button of the mouse.
buttonN: The Nth button of the mouse (The number of available buttons depends of the mouse model).

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:

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!

Mapping Special Actions

The following special actions are available¹:

disabled: disable the button,
dpi: use this button to switch between DPI presets,
ScrollUp: simulate a scroll up (not available on all devices¹)
ScrollDown: simulate a scroll down (not available on all devices¹)

Example:

buttons(button4=disabled; button5=disabled; button6=DPI)

Note

¹ The ScrollUp and ScrollDown actions are not available on all devices.

Rival 300 / Rival: OK
Sensei [RAW]: Not supported

Mapping Mouse Buttons

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)

Mapping Multimedia Keys

Mouse buttons can be mapped to multimedia keys. The following keys are available:

Mute: turn off the sound
Next: play next media
PlayPause: toggle play / pause on the currently playing media
Previous: play the previous media
VolumeUp: increase the volume
VolumeDown: decrease the volume

Example:

buttons(button4=VolumeDown; button5=VolumeUp)

Mapping Keyboard Keys

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.

Available layouts:

QWERTY (see available keys)

The available keys depend on the selected layout.

Example:

buttons(layout=QWERTY; button7=PageDown; button8=PageUp)

Note

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 =).

Example:

buttons(button4=semicolon; button5=equal)

Python API

TODO