[[Vorlage(Getestet, focal, bionic)]]
{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Programme_starten: Starten von Programmen]
[:Paketquellen_freischalten/PPA: PPAs verwenden]
}}}
[[Inhaltsverzeichnis(1)]]
[[Bild(logo-piper.png,72,align=left)]]
[github:libratbag/piper:Piper] ist eine grafische Benutzeroberfläche zur Konfiguration von Gaming-Mäusen (u.a. Logitech und SteelSeries) und den [:Dienste:Dienst] ratbagd. Piper baut dafür auf [github:libratbag/libratbag:libratbag] auf, das den Dienst bereitstellt.

Piper bietet die Möglichkeit Tastenbelegung, Abtastrate und -auflösung, sowie die LED-Beleuchtung anzupassen. Piper ist damit das freie Pendant zu den offiziellen, proprietären Tools der Hardware-Hersteller, die in der Regel nicht für Ubuntu/Linux angeboten werden.

Im GitHub-Wiki des Projekts wird eine [https://github.com/libratbag/libratbag/wiki/Devices Liste der unterstützten Mäuse] {en} geführt. Darunter sind alle aktuellen Mäuse der Logitech G-Series und aktuelle Modelle des Herstellers SteelSeries. 

{{{#!vorlage Tabelle
<tablestyle="float:right; clear:right" :>[[Bild(Piper_Aufloesung.png, x240)]]
[[Bild(Piper_Tasten.png, x240)]]
[[Bild(Piper_LEDs.png, x240)]]
+++
<:>Ausflösung
<:>Tastenbelegung
<:>LEDs
}}}
= Installation =
== Ubuntu 20.04 ==
Piper ist ab [:Focal Fossa:Ubuntu 20.04] in den offiziellen Paketquellen enthalten und kann ohne hinzufügen von Paketquellen installiert werden [1]:

{{{#!vorlage Paketinstallation
piper, universe
}}}

Nach der Installation kann das Programm dann sofort gestartet werden [2].

== Ubuntu 19.10 und früher ==
Unter [:Eoan Ermine:Ubuntu 19.10] und früher muss zunächst das PPA hinzugefügt werden[3].

[[Vorlage(PPA, libratbag-piper/piper-libratbag-git)]]

Piper und die zugehörigen Abhängigkeiten können anschließend, installiert werden[1]:

{{{#!vorlage Paketinstallation
piper
}}}

Nach der Installation kann das Programm dann sofort gestartet werden[2].

= Bedienung =
Nach dem Start von Piper wird die Maus, sofern sie zu den unterstützen Geräten gehört, sofort erkannt. Im Piper-Fenster wird die Maus als graue Silhouette dargestellt. Über die drei Reiter ''"Auflösungen"'', ''"Tasten"'' und ''"LEDs"'' kann die Maus konfiguriert werden.

{{{#!vorlage Tabelle
<rowclass="titel"-2>Piper
+++
<rowclass="kopf">Reiter
Beschreibung
+++
''"Auflösungen"'' 
Unter diesem Punkt kann die Abtastrate und die Abtastauflösung des optischen Sensors der Maus festgelegt werden. Alle Änderungen müssen über den Button ''"Zuweisen"'' gespeichert werden.
+++
''"Tasten"'' 
Hier kann die Belegung sämtlicher Maustasten geändert werden. Neben vordefinierten Funktionen besteht auch die Möglichkeit eine eigene Tastenkombination aufzuzeichnen und einer der Maustasten zuzuweisen. Alle Änderungen müssen auch hier über den Button ''"Zuweisen"'' gespeichert werden.
+++
''"LEDs"'' 
An dieser Stelle kann die LED-Beleuchtung der Maus angepasst werden. Dabei kann zwischen einer konstanten Beleuchtung, einem pulsierenden Effekt oder einem zyklischen Farbwechsel gewählt werden. Für Letzteres muss die Maus natürlich einen Farbwechsel unterstützten (RGB-Beleuchtung). Alle Änderungen müssen auch hier über den Button ''"Zuweisen"'' gespeichert werden.
}}}

= Kommandozeile =
Piper ist praktisch "nur" eine grafische Benutzeroberfläche für den Dienst ratbagd. Mit `ratbagctl` gibt es ein Kommandozeilenprogramm, mit dem ebenfalls sämtliche Konfigurationen vorgenommen werden können. Die [:man:Manpage] gibt eine Übersicht sowie Beispiele zu den möglichen Befehlen.

= Infobox =
{{{#!vorlage Tabelle
<rowclass="titel"-2> Logitech
+++
<rowclass="kopf">[:Systeminformationen_ermitteln/#USB:USB-ID]
Modell 
+++
<cellclass="befehl">046d:c07e Logitech, Inc. G402 Gaming Mouse
Logitech G402 Hyperion Fury
}}}

[[Bild(logo-ratbag.png,80,align=right)]]
= Links =
 * [:Eingabegeräte:] {Übersicht}
 * [github:libratbag/piper:Piper auf GitHub] {en}
 * [github:libratbag/libratbag/wiki/Devices:Liste der unterstützten Mäuse] {en}

#tag: Hardware, Spiele, Maus, Eingabegeräte, Logitech