-
Notifications
You must be signed in to change notification settings - Fork 175
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:
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.
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.
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.