SteelSeries Rival 700 and Rival 710

Supported Models

SteelSeries Rival 700

1038:1700

SteelSeries Rival 710

1038:1730

Missing Features

The following feature are currently not supported by Rivalcfg:

  • OLED screen image

Command-Line Usage

usage: rivalcfg [-h] [--list] [--version] [--no-save] [--update-udev]
                [--print-udev] [--print-debug] [-s SENSITIVITY1]
                [-S SENSITIVITY2] [-p POLLING_RATE] [-c LOGO_COLOR]
                [-C WHEEL_COLOR] [-r] [--firmware-version]

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 700 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 LOGO_COLOR, --logo-color LOGO_COLOR
                        Set the logo colors and effects (default:
                        rgbgradient(duration=1000; colors=0%: #ff00e1, 33%:
                        #ffea00, 66%: #00ccff))
  -C WHEEL_COLOR, --wheel-color WHEEL_COLOR
                        Set the wheel colors and effects (default:
                        rgbgradient(duration=1000; colors=0%: #ff00e1, 33%:
                        #ffea00, 66%: #00ccff))
  -r, --reset           Reset all settings to their factory default
  --firmware-version    Print the firmware version of the mouse and exit

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)},
    ]
}

Python API

TODO