rivald

Library to interface with the Steelseries Rival 310 mouse


Keywords
library, development
License
GPL-3.0
Install
dub fetch rivald --version 0.0.2

Documentation

rivald

Library (and cli tool) to interface with the Steelseries Rival 310 mouse

TODO
  • rivaltool
  • Buttons/Macros
  • Button report

Build

mkdir build
cd build
meson ..
You should also be able to build this with dub

Dependencies

Compiler

This project was tested with DMD and LDC backends.

If you want to change the compiler.

DC=ldc meson ..

Protocol Information

See rival310-re.

Related Projects

  • RivalGUI - GTK+ based tool to configure the Steelseries Rival 310 mouse. (via rivald)
  • libratbag - A DBus daemon to configure gaming mice.
  • piper - GTK+ application to configure gaming mice, using libratbag via ratbagd.
  • rivalcfg - Small CLI utility program that allows you to configure SteelSeries Rival gaming mice.

Driver backend comparison (Steelseries Rival 310 only)

Backend LEDs DPI Report Rate Read Values Buttons (Macros) Button Report
Official Driver Partial (90%) Full Full Full Full None
rivald Full Full Full Full [1] None (yet) None (yet)
libratbag Partial (70%) Full Full None Partial (90%) None
rivalcfg None (yet) Full None None None None

[1] Supports everything currently known. There isn't any official information regarding the protocol. All of the public knowledge regarding it was obtained via reverse engineering. This can be hard especially when reading values from the device.

Applications

Application Backend Type Backend Type Operating Systems
rivaltool rivald CLI Standalone Linux, Window* and MacOS*
RivalGUI rivald GUI Hybrid [1] Linux, Window* and MacOS*
Piper libratbag GUI Daemon Linux
ratbagctl libratbag CLI Daemon Linux
rivalcfg rivalcfg CLI Standalone Linux, Window* and MacOS*

* Not tested

License

This software is licensed under the GNU General Public License v3.0.

Author(s)

  • Filipe Laíns (FFY00) - Main contributor (base software and reverse engineering)