Wie kann ich in Keypirinha ein benutzerdefiniertes Plugin installieren?
- Einleitung
- Vorbereitung
- Plugin-Verzeichnis finden
- Plugin-Datei kopieren
- Keypirinha neu starten oder Plugins neu laden
- Plugin prüfen und verwenden
- Fehlerbehebung
Einleitung
Keypirinha ist ein schneller und anpassbarer Launcher für Windows, der sich durch Plugins erweitern lässt. Um die Funktionalität von Keypirinha zu erweitern, können benutzerdefinierte Plugins hinzugefügt werden. Diese Plugins sind in der Regel Python-Skripte, die im richtigen Verzeichnis abgelegt und ggf. aktiviert werden müssen. Im Folgenden wird ausführlich erklärt, wie man ein benutzerdefiniertes Plugin in Keypirinha installiert.
Vorbereitung
Bevor Sie ein benutzerdefiniertes Plugin installieren, sollten Sie sicherstellen, dass Sie eine aktuelle Version von Keypirinha installiert haben. Plugins werden als Python-Skripte mit der Endung .py geliefert. Diese Skripte können entweder selbst geschrieben oder aus dem Internet heruntergeladen worden sein. Idealerweise verfügen Sie über eine Datei, die das Plugin enthält, beispielsweise mein_plugin.py.
Plugin-Verzeichnis finden
Keypirinha verfügt über ein spezielles Verzeichnis für benutzerdefinierte Plugins. Dieses heißt Packages\User und befindet sich im Keypirinha-Datenordner. Um diesen Ordner zu öffnen, gehen Sie wie folgt vor: Öffnen Sie Keypirinha, tippen Sie Configure in das Suchfeld ein und wählen Sie anschließend den Punkt Open User Packages Folder. Alternativ können Sie auch direkt zum Pfad %APPDATA%\Keypirinha\Packages\User navigieren. In diesem Ordner legen Sie Ihre benutzerdefinierten Plugins ab.
Plugin-Datei kopieren
Nehmen Sie nun die Python-Plugin-Datei, also beispielsweise mein_plugin.py, und kopieren Sie diese in den User-Ordner. Dabei ist es wichtig sicherzustellen, dass die Datei direkt in diesem Verzeichnis liegt und sich nicht etwa in einem weiteren Unterordner. Keypirinha lädt alle .py-Dateien aus diesem Verzeichnis automatisch beim Start oder beim Neuladen.
Keypirinha neu starten oder Plugins neu laden
Nachdem das Plugin im User-Paketordner platziert wurde, müssen Sie Keypirinha veranlassen, das neue Plugin zu laden. Dies erreichen Sie entweder durch einen Neustart von Keypirinha oder durch das Drücken der Tastenkombination Win + Ctrl + R, welche das Neuladen der Plugins und Konfiguration auslöst. Danach sollte Ihr neues Plugin aktiv sein.
Plugin prüfen und verwenden
Nach der Installation können Sie prüfen, ob das Plugin funktioniert, indem Sie die im Plugin definierten Befehle oder Funktionen in Keypirinha aufrufen. Die genaue Verwendung hängt vom jeweiligen Plugin ab, daher hilft es oftmals, die Dokumentation des Plugins zu lesen. Einige Plugins zeigen auch eigene Treffer im Launcher an oder bieten eigene Aktionen an.
Fehlerbehebung
Falls das Plugin nicht wie erwartet funktioniert, können Sie im Log von Keypirinha nach Fehlermeldungen suchen. Dieses Log ist über das Kontextmenü in Keypirinha unter Open Log File zugänglich. Probleme können durch Python-Syntaxfehler, fehlende Abhängigkeiten oder falsche Plugins-Dateipfade verursacht werden. Überprüfen Sie deshalb immer den Pfad, die Dateiendung und die Kompatibilität des Plugins mit Ihrer Keypirinha-Version.