Skip to content

v0.1.0

Choose a tag to compare

View all tags
@D3m0nZOnFire D3m0nZOnFire released this 18 Oct 09:21
· 14 commits to main since this release
v0.1.0
1755e0c

First tagged release. Configure gaming mice on Linux over /dev/hidraw*, without vendor software. Pure Python 3 standard library: no packages, no venv.

Supported mice

Mouse Links id / alias
Attack Shark X11 wired 1d57:fa55, dongle 1d57:fa60 attackshark-x11 / ashark
Rapoo VT3 PRO wired 24ae:4431, dongle 24ae:1231 rapoo-vt3pro / vt3pro
Pulsar X3 (PX3R21) wired 3710:3409 / 3410, dongle 3710:5402 / 5403 (8K) pulsar-x3 / x3

What's in it

  • CLI: list, status, keys, get, set, battery (with --json), save / restore
  • mousectl tui: every connected mouse in one curses TUI
  • DPI stages, polling rate (up to 8K on the Pulsar dongle), lighting and battery, depending on the mouse
  • An automatic backup of the mouse's original settings before the first write (~/.config/mousectl/<id>/auto-backup.json)
  • mousectl install-udev: a uaccess udev rule so it runs without root

Install

git clone https://github.com/D3m0nZOnFire/mousectl && cd mousectl
./install.sh            # symlinks mousectl into ~/.local/bin
mousectl install-udev   # only if you get permission errors

New mouse? See docs/ADDING_A_DRIVER.md.

Assets 2
Loading