Piper - A Linux mouse configuration tool for Logitech (and a few other) mice

Piper - A Linux mouse configuration tool for Logitech (and a few other) mice

Lohitech G502 Hero corded mouse

Piper, configure your Logitech G502 Hero mouse

Several months ago I bought a Logitech Hero 502 mouse on sale ($49.99CDN was $99.99) at Canada Computers. Recently I discovered Piper, a program that provides a graphical way to configure the Logitech Hero 502, and several other Logitech (and a few other brands of) mice. For a full list of Piper supported mice see the libratbag list of devices here: https://github.com/libratbag/libratbag/tree/master/data/devices. Piper is a graphical front end to libratbag.

Piper interface for the Logitech G502
Piper interface for the Logitech G502 Hero mouse

Piper is in the Ubuntu Universe repository, so it can be installed with:

sudo apt install piper

If you prefer something more up to date see the git repository here: https://github.com/libratbag/piper Instructions for building piper from git are included on the page, but it's worth mentioning that this isn't a simple ./configure, make, make install, you'll need to use the meson build system. I installed the older client in the Ubuntu software repository. The latest version has a Russian translation, so if you work in Russian, you may want to give it a try.

Buttons along the top

For the Logitech G502 Hero there are 3 tabs along the top of the Piper GUI: Resolutions, Buttons, and LEDs. There are also 3 buttons along the top: Profile, Apply, and a gear button that just brings up an About Piper window (along with the usual window manager buttons to minimize, maximize and close the window). Clicking the profile button lets you choose from up to 5 profiles (0 to 5). You can configure the resolutions, buttons, and LEDs differently for each profile. This lets you switch quickly between sets of mouse options. For example: one profile might turn off the mouse LED and drop the resolution for day time work use, while another profile could be used to pulse the LED red and increase the resolution to 6400 DPI for game use.

Piper buttons / actions
Piper interface buttons along the top

Changing mouse resolution

To change resolution click the Resolutions tab/button along the top of piper. Piper lists 1200dpi, 2400dpi, 3200dpi, 6400dpi, and 0dpi. Clicking on any of these DPI settings reveals a slider that can be used to finely adjust the mouse DPI. The Logitech G502 Hero supports up to 16000 DPI. Piper does indeed go to 16000DPI if you click any of the DPI settings and adjust the slider to the maximum setting.

Changing mouse button functions

Every button on the Logitech G502 Hero can also be set to something different. The mouse button actions include: Left mouse button click, right mouse button click, middle mouse button click, backward, forward, button 5 click, button 6 click, button 7 click, button 8 click, button 9 click, double click, wheel left, wheel right, wheel up, wheel down, ratchet mode, cycle resolution up, cycle resolution down, resolution up, resolution down, default resolution, cycle profile up, cycle profile down, profile up, profile down, second mode, battery level and send keystroke, which lets you assign a keyboard key to the mouse button. Including the parts of the scroll wheel the Logitech G502 Hero has 11 buttons that can be assigned.

Assign the buttons on the Logitech G502 Hero
Assign the buttons on the Logitech G502 Hero

LEDs - Modify 2 LEDs on mouse

There are two LEDs on the G502 Hero that can be set, the obvious "G" on the mouse, and a sliver of an LED on the left side of the mouse. The colour of the LEDs can be set various ways. First, just about any colour can be set for both LEDs. Second, the way the mouse LED appears can be set to options that include: solid colour, cycling (between colours), breathing (where the mouse fades and gets brighter), or off. The brightness and duration of each of these options/effects can also be set.

Logitech G502 Hero LED light options
Logitech G502 Hero LED light options

Piper - crashes, but works

Piper is pretty capable for a simple-looking program. If you have a Logitech G502 Hero, or another mouse supported by Libratbag, you may want to install piper. I use it at night to switch profiles to a profile where the LEDs are turned off. I found piper occasionally crashed, but it worked for me most of the time, and I had no problem setting different options for the Hero.

If you've used Piper before please leave a comment below.