Skip to content

BallKey 0.1.5: wheel tilt and buttons that type keys

Choose a tag to compare

@gino8807 gino8807 released this 21 Oct 14:16
· 13 commits to main since this release

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.