开源Rivalcfg:配置 SteelSeries 游戏鼠标


Rivalcfg 是一个非官方的 Python 库和命令行工具,用于在 Linux、macOS 和 Windows 系统上配置 SteelSeries(赛睿)游戏鼠标。该项目通过逆向工程实现,并非由 SteelSeries 官方支持或认可


主要功能

  • DPI 调节:支持为不同设备设置灵敏度(CPI/DPI)值
  • 按键映射(Button Mapping):支持自定义鼠标按键功能
  • 灯光控制:支持设置 LED 颜色、渐变(gradient)和灯光效果
  • 抬升距离(Lift-Off Distance):部分设备支持调整 LOD 设置
  • 睡眠/休眠定时器:无线设备支持设置睡眠和屏幕调暗定时器
  • 固件版本查询:支持读取多种设备的固件版本
  • 电池电量读取:支持读取无线鼠标的电池电量

完整支持设备列表请参考:rivalcfg.flozz.org/devices.html

安装方式

  1. 从源码安装(Python 3.10+)
  2. 独立可执行文件(Standalone Build):支持 Linux、Windows、macOS,无需安装 Python 环境
详细安装说明请参考:flozz.github.io/rivalcfg/install.html


使用示例

# 查看可用设备
rivalcfg --list-devices

# 设置 DPI
rivalcfg --dpi 800

# 设置 LED 颜色
rivalcfg --color ff0000

# 查询固件版本
rivalcfg --firmware-version

# 生成 udev 规则(Linux 下需要)
rivalcfg --print-udev