rivald ~master

Library to interface with the Steelseries Rival 310 mouse


To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:

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.

  • 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)
BackendLEDsDPIReport RateRead ValuesButtons (Macros)Button Report
Official DriverPartial (90%)FullFullFullFullNone
rivaldFullFullFullFull [1]None (yet)None (yet)
libratbagPartial (70%)FullFullNonePartial (90%)None
rivalcfgNone (yet)FullNoneNoneNoneNone

[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
ApplicationBackendTypeBackend TypeOperating Systems
rivaltoolrivaldCLIStandaloneLinux, Window and MacOS**
RivalGUIrivaldGUIHybrid [1]Linux, Window and MacOS**
PiperlibratbagGUIDaemonLinux
ratbagctllibratbagCLIDaemonLinux
rivalcfgrivalcfgCLIStandaloneLinux, Window and MacOS**

* Not tested

[1] RivalGUI uses the rivald backend but is (not yet, will be) compatible with ratbagd (libratbag's daemon).

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)
Authors:
  • Filipe Laíns
Dependencies:
hidapi-d
Versions:
0.0.2 2018-Aug-23
0.0.1 2018-Jul-08
~master 2018-Aug-23
Show all 3 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 0 downloads this month

  • 11 downloads total

Score:
0.7
Short URL:
rivald.dub.pm