Skip to content

Instantly share code, notes, and snippets.

@plembo
Last active December 1, 2021 14:15
Show Gist options
  • Save plembo/bdd2d35b38c01c8dc95f198b0c147e98 to your computer and use it in GitHub Desktop.
Save plembo/bdd2d35b38c01c8dc95f198b0c147e98 to your computer and use it in GitHub Desktop.
Controling Mice with Piper

Using Piper for Mouse Control

These are not my notes on how we rid our crawlspace of vermin a couple of years ago (spoiler alert: firearms were not, as usual in suburbia, necessary to get that job done). Rather, they're how I integrated by new Logitech G203 Lightsync mouse with my Ubuntu workstation.

Like many gaming mice, the Logitech G203 works fine out of the box with Linux. However, if you want to actually control the DPI or LED settings, you'll need a desktop utility like Logitech's G-HUB.

Of course there's no G-HUB for Linux, but fortunately the libratbag project provides an alternative.

Their ratbagd service and its Piper GUI work together assert control over mice like the G203.

Setting things up on Ubuntu is made infinitely easier (and reliable) by using the project's PPA repository:

$ sudo add-apt-repository ppa:libratbag-piper/piper-libratbag-git
$ sudo apt update
$ sudo apt install ratbagd piper

Since there's already a device definition for the G203 installed at /usr/share/libratbag/logitech-g102-g203.device, all I had to do was run Piper to start controlling my mouse.

NOTE: See the device notes in the libratbag wiki for a list of supported devices and any limitations on their control (for example, currently libratbag cannot differentiate between the G203's three separate LED zones).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment