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
                        Set sensitivity preset 1 (DPI) (from 100 to 12000,
                        default: 800)
  -S, --sensitivity2 SENSITIVITY2
                        Set sensitivity preset 2 (DPI) (from 100 to 12000,
                        default: 1600)
  -p, --polling-rate POLLING_RATE
                        Set polling rate (Hz) (values: 125, 250, 500, 1000,
                        default: 1000)
  -c, --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
                        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