Repository navigation
BallKey 0.1.5: wheel tilt and buttons that type keys
Wheel tilt
If your scroll wheel tilts left and right, Wheel tilt left and Wheel tilt right now appear in the button list, and you can give them any action (for example Back and Forward). Left on Default, tilting scrolls sideways as before.
Buttons that type keys
Some gaming mice, like the Logitech G502, have buttons that type a shortcut (for example Ctrl+C) instead of acting as mouse buttons. BallKey couldn't see these before. Now click Identify button and press one: it's added as "Button that types Ctrl+C", and you can give it any action. Left on Default, it keeps typing its shortcut. Your keyboard is never affected.
Buttons the mouse handles by itself, like the G502's DPI and sniper buttons, send nothing to the computer, so BallKey can't change them. For DPI and those buttons, use Piper, which works alongside BallKey.
Install
| Distribution | File | Install |
|---|---|---|
| Fedora 44+ | ballkey-0.1.5-1.fc44.noarch.rpm |
Double-click it, or sudo dnf install ./ballkey-0.1.5-1.fc44.noarch.rpm |
| Debian-based | ballkey_0.1.5-1_all.deb |
sudo apt install ./ballkey_0.1.5-1_all.deb |
| Arch Linux | ballkey-0.1.5-1-any.pkg.tar.zst |
sudo pacman -U ballkey-0.1.5-1-any.pkg.tar.zst |
Fedora: if you installed 0.1.3 or later, Discover / Software and dnf upgrade will offer this update by themselves.
Your settings and your "Start remapping at boot" choice are kept when you upgrade. SHA256SUMS lets you verify the downloads.
BallKey has been tested on real hardware (Fedora KDE) with a Logitech G502 HERO, Logitech G403 and Kensington Expert.
BallKey was vibecoded and is my first project; see the README for what that means and how it was tested. Bug reports and code review are very welcome.