Piper

Piper is a GTK+ application to configure gaming mice, using libratbag via ratbagd.

In order to run Piper, ratbagd has to be running (without it, you'll get to see a pretty mouse trap). To see how, see its README.

If you are running piper from git, we recommend using libratbag from git as well to make sure the latest bugfixes are applied.

Screenshots

Installing Piper

Piper uses the meson build system which in turn uses ninja to build and install itself. Run the following commands to clone Piper and initialize the build:

$ git clone https://github.com/libratbag/piper.git
$ cd piper
$ meson builddir --prefix=/usr/

To build or re-build after code-changes, run:

$ ninja -C builddir
$ sudo ninja -C builddir install

Note: builddir is the build output directory and can be changed to any other directory name.

Contributing

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.

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

Source

git clone https://github.com/libratbag/piper.git

Bugs

Bugs can be reported in the issue tracker on our GitHub repo: https://github.com/libratbag/piper/issues

License

Licensed under the GPLv2. See the COPYING file for the full license information.