Piper is a GTK+ application to configure gaming mice. Piper is merely a graphical frontend to the ratbagd DBus daemon, see the libratbag README for instructions on how to run ratbagd.
If you are running piper from git, we recommend using libratbag from git as well to make sure the latest bugfixes are applied.
Piper is merely a frontend, the list of supported devices depends on libratbag. See the libratbag device files for a list of all known devices. The device-specific protocols usually have to be reverse-engineered and the features available may vary to the manufacturer's advertized features.
And if you see the mousetrap, something isn't right. Usually this means that either ratbagd is not running (like in this screenshot), ratbagd needs to be updated to a newer version, or some other unexpected error occured.
Most popular distributions package Piper and it is available through the packaging system (apt, dnf, yum, pacman, ...). This is the preferred way of installing Piper.
Piper is also available as a Flatpak. For technical reasons, ratbagd cannot be flatpaked yet so users must install ratbagd through their distribution packaging system.
Building Piper from git
$ git clone https://github.com/libratbag/piper.git $ cd piper $ meson builddir --prefix=/usr/
This blog post explains how to spot and install missing dependencies.
To build or re-build after code-changes and install, run:
$ ninja -C builddir $ sudo ninja -C builddir install
builddir is the build output directory and can be changed to any other
Yes please. It's best to contact us first to see what you could do. Note that the devices displayed by Piper come from libratbag.
For quicker development iteration, there is a special binary
that uses data files from the git directory. This removes the need to
install piper after every code change.
$ ninja -C builddir $ ./builddir/piper.devel
Note that this still requires ratbagd to run on the system bus.
Piper tries to conform to Python's PEP8 style guide. To verify your code before
opening a PR, please install
flake8 and run the following commands to install
its pre-commit hook:
$ flake8 --install-hook git $ git config --bool flake8.strict true
git clone https://github.com/libratbag/piper.git
Bugs can be reported in the issue tracker on our GitHub repo: https://github.com/libratbag/piper/issues
Licensed under the GPLv2. See the COPYING file for the full license information.