SteelSeries Rival 600

Supported Models

SteelSeries Rival 600

1038:1724

SteelSeries Rival 600 Dota 2 Edition

1038:172e

Command-Line Usage

usage: rivalcfg [-h] [--list] [--version] [--no-save] [--update-udev]
                [--print-udev] [--print-debug] [-s SENSITIVITY1]
                [-S SENSITIVITY2] [-p POLLING_RATE] [-C WHEEL_COLOR]
                [-c LOGO_COLOR] [--left-strip-top-color Z2_COLOR]
                [--right-strip-top-color Z3_COLOR]
                [--left-strip-middle-color Z4_COLOR]
                [--right-strip-middle-color Z5_COLOR]
                [--left-strip-bottom-color Z6_COLOR]
                [--right-strip-bottom-color Z7_COLOR] [-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 Rival 600 Options:
  -s SENSITIVITY1, --sensitivity1 SENSITIVITY1
                        Set sensitivity preset 1 (DPI) (from 100 to 12000,
                        default: 800)
  -S SENSITIVITY2, --sensitivity2 SENSITIVITY2
                        Set sensitivity preset 2 (DPI) (from 100 to 12000,
                        default: 1600)
  -p POLLING_RATE, --polling-rate POLLING_RATE
                        Set polling rate (Hz) (values: 125, 250, 500, 1000,
                        default: 1000)
  -C WHEEL_COLOR, --wheel-color WHEEL_COLOR, --z0 WHEEL_COLOR
                        Set the colors and the effects of the wheel LED
                        (default: rgbgradient(duration=1000; colors=0%:
                        #ff0000, 33%: #00ff00, 66%: #0000ff))
  -c LOGO_COLOR, --logo-color LOGO_COLOR, --z1 LOGO_COLOR
                        Set the colors and the effects of the logo LED
                        (default: rgbgradient(duration=1000; colors=0%:
                        #ff0000, 33%: #00ff00, 66%: #0000ff))
  --left-strip-top-color Z2_COLOR, --z2 Z2_COLOR
                        Set the colors and the effects of the top LED of the
                        left strip (default: rgbgradient(duration=1000;
                        colors=0%: #ff0000, 33%: #00ff00, 66%: #0000ff))
  --right-strip-top-color Z3_COLOR, --z3 Z3_COLOR
                        Set the colors and the effects of the top LED of the
                        right strip (default: rgbgradient(duration=1000;
                        colors=0%: #ff0000, 33%: #00ff00, 66%: #0000ff))
  --left-strip-middle-color Z4_COLOR, --z4 Z4_COLOR
                        Set the colors and the effects of the middle LED of
                        the left strip (default: rgbgradient(duration=1000;
                        colors=0%: #ff0000, 33%: #00ff00, 66%: #0000ff))
  --right-strip-middle-color Z5_COLOR, --z5 Z5_COLOR
                        Set the colors and the effects of the middle LED of
                        the right strip (default: rgbgradient(duration=1000;
                        colors=0%: #ff0000, 33%: #00ff00, 66%: #0000ff))
  --left-strip-bottom-color Z6_COLOR, --z6 Z6_COLOR
                        Set the colors and the effects of the bottom LED of
                        the left strip (default: rgbgradient(duration=1000;
                        colors=0%: #ff0000, 33%: #00ff00, 66%: #0000ff))
  --right-strip-bottom-color Z7_COLOR, --z7 Z7_COLOR
                        Set the colors and the effects of the bottom LED of
                        the right strip (default: rgbgradient(duration=1000;
                        colors=0%: #ff0000, 33%: #00ff00, 66%: #0000ff))
  -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=disabled; button7=dpi))
  -r, --reset           Reset all settings to their factory default

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

Colors

This mouse supports colors. Various formats are supported.

Hexadecimal notation

You can use a 24 bit hexadecimal notation (like in HTML / CSS documents). Example of “red” color using hexadecimal notation:

  • #FF0000

  • FF0000

  • #F00

  • F00

Named Colors

The folowing named colors are supported:

white

red

lime

blue

silver

maroon

green

navy

gray

yellow

aqua

fuchsia

black

olive

teal

purple

RGB Tuple (Python API only)

If you are using the Python API (not the command line interface), you can also pass colors as RGB tuple or list:

  • (255, 0, 0)

  • [255, 0, 0]

RGB Gradients

This mouse supports RGB Gradient. In addition of static colors, you can configure a gradient. The color of the mouse will change according to the colors of the gradient.

RGB Gradient expression

The RGB Gradient follows this format:

rgbgradient(duration=<DURATION>; colors=<POS1>: <COLOR1>, <POSN>: COLORN>)
  • duration: the time in miliseconds of the color loop. This parameter is optional. Default value: 1000 (1 second).

  • colors: the colors of the gradient.

    • The <POS> parameters are the position of the color stops (e.g. 0%, 50%,…).

    • The <COLOR> parameters are the colors in any suported format (se above).

Note

A maximum of 14 color are supported in a RGB Gradient.

Example Gradients

rgbgradient(duration=5000; colors=0%: red, 33%: lime, 66%: blue)
rgbgradient(duration=5000; colors=0%: #e90cce, 33%: #ffe701, 66%: #01cafe)
rgbgradient(duration=1000; colors=0%: #ff1800, 50%: #fde700)
rgbgradient(duration=1000; colors=0%: #3acbe8, 50%: #8706fe)
rgbgradient(duration=15000; colors=0%: black, 8%: red, 16%: black, 24%: yellow, 32%: black, 40%: lime, 48%: black, 56%: aqua, 64%: black, 72%: blue, 80%: black, 88%: fuchsia)

RGB Gradient Dict (Python API only)

If you are using the Python API (not the command line interface), you can also pass a Python dict to define a gradient.

Example:

{
    "duration": 5000,  # ms
    "colors": [
        {"pos": 0, "color": "red"},
        {"pos": 33, "color": "#00FF00"},
        {"pos": 66, "color": (0, 0, 255)},
    ]
}

Buttons

Rival 600 buttons schema

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:

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