Installation

You can install Piper by either using your distribution's repository (preferred if it exists), using the Flatpak or by building it from source. Piper is packaged for the following distributions:

Using your distribution's repository

We are aware of the following distributions shipping Piper in their repositories:

• Fedora: dnf install piper
• Arch: pacman -S piper
• Debian: sudo apt install piper (>= Debian 11 / bullseye)
• Ubuntu: sudo apt install piper (>= Ubuntu 20.04 / focal, inside universe repository)
• For Ubuntu version older than this you can use this PPA.
• OpenSUSE: zypper install piper
• Solus: eopkg it piper

If your favorite distribution also ships Piper, please let us know so we can add it to the list here.

Installing the Flatpak

Piper is also available as a Flatpak. For technical reasons, ratbagd cannot be flatpaked yet so users must install manually. The Piper flatpak requires the latest version of libratbag.

You can find Piper on Flathub here.

Building from source

Install the distribution-specific build dependencies first.

Piper uses the meson build system version 0.42 or later, 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/

If you run into missing dependencies, see our FAQ and/or this blogpost.

To build or re-build after code-changes and install, 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.