Use Piper to configure Logitech, Steelseries and other gaming mice on Linux

I recently bought a new mouse and I am looking for a way to configure it under Linux. The mouse is Logitech G102.In most places Solar It is the preferred software to configure Logitech mouse (and other Logitech devices (such as keyboard or trackpad)) on Linux, but it doesn’t seem to support my G102 because I received an error message saying “Logitech could not be found receiver”.

After some digging, I found that “Solaar will detect all devices paired with your Unifying, Lightspeed or Nano receiver, and display at least some basic information about them. Solaar will detect some Logitech devices connected via USB cable or Bluetooth “. Therefore, it seems that Solaar is mainly used for Logitech devices that use USB receivers.


So I have to look elsewhere, this is my way Find More about Piper, This is a GTK application for configuring gaming mouse on Linux (using Liberation bag, A DBus daemon, used to configure input devices, mainly gaming mice. It supports devices from Logitech, Etekcity, G.Skill, Roccat, Nubwo and Steelseries, such as:

  • Logitech G602, G502 Hero / Hero Wireless / Proteus Core / Proteus Spectrum, G903, G903 Hero, G Pro, G Pro Wireless, G102, G204, G300, G3002, G303, G402, G403, G403 Hero / Wireless, etc.
  • Roccat Kone Pure and Kone XTD
  • Steelseries Kinzu v2, Kinzu v2 Pro, Kinzu v3, Rival, Rival 310/600 and Sensei Raw/310
  • Etekcity Scroll Alpha
  • Nubwo X7 spectrum
  • Glorious Type D and Type O
  • G.Skill MX780

The list of supported mice is constantly increasing, so please check Complete list.

In terms of functions, Piper supports the following functions:

  • Set mouse sensitivity (report rate) and resolution (DPI)
  • Configure mouse buttons (including macros, if supported by the device)
  • Configure LED color
  • Custom mouse profile

I only learn about the profile function from the Piper screenshot on its project page, because the button is missing in my case (I am using the latest Piper, so I think this is because my mouse does not support it).

Here are some screenshots with Piper buttons and LED settings:

Piper configures Logitech mouse macro LinuxPiper configure mouse LED Linux

So far, the application works well when adjusting my Logitech G102 mouse on the Ubuntu 20.10 desktop, but I do have some complaints. For starters, it does not have a tray icon, which may be very helpful for viewing the current DPI or changing the configuration file (if they can be used), for example.

Piper will not notify you in any way when changing the DPI using the assigned mouse button. In addition, even with the restarted application, the Piper user interface cannot correctly display the active DPI when changes are made using the assigned mouse buttons.

By the way, if you have a gaming mouse on Linux, you need to disable mouse acceleration, especially when playing FPS games. Please refer to this article to learn how to disable mouse acceleration in Ubuntu/GNOME.

Install Piper to configure a gaming mouse on Linux

For most Linux distributions, Piper should be available in the official repository. Use the following method to install:

  • Debian spoilers (supporters), bullseye and sid / Ubuntu 20.04 and 20.10 / Linux Mint 20 / Pop! _OS 20.04 and 20.10 / Zorin OS and other Linux distributions based on Debian or Ubuntu:
sudo apt install piper

  • Fedora:
sudo dnf install piper

  • Arch Linux / Manjaro:
sudo pacman -S piper

  • openSUSE:
sudo zypper install piper

For Ubuntu, Linux Mint and Pop! _OS users, one more PPA If the version you need to use is newer than the version available in the repository, that version has the latest Piper and libratbag from Git. PPA also has packages suitable for older versions of Ubuntu, such as 18.04 (Bionic).

I can’t list every Linux distribution here, so if you use other distributions, search for Piper in the repository and install it from there.

Piper too Installable from Flathub, And then you can install it on most Linux distributions.If Piper/libratbag added support for the mouse only recently (see Supported mice), and you are using an old version of Piper/libratbag, please install the Piper Flahub package.

To install Piper from Flathub, you need to install Flatpak and add the Flathub repository.You can find instructions on how to do this on Flathub Quick Setup page. You only need to set up Flatpak and Flathub once. After that, you can take advantage of the large application database it provides for installation with very little effort.

After setting up Flatpak and Flathub, go to Piper Flathub page Then click the install button. If you are a Gnome user, you can also search on Gnome Software / Ubuntu Software and install from there. If you are a Gnome user, you can also search for it on the Gnome software and install it from there.

You can also install Piper from Flathub on Linux using the following command:

flatpak install flathub org.freedesktop.Piper

You might like:

  • How to use Atbswp macro recorder (GUI) to record and play mouse and keyboard events
  • How to bind mouse buttons to keyboard keys or commands (Linux uses X11)