Omarchy-Plugin
Libre WebUI liefert ein offizielles Plugin für Omarchy, den meinungsstarken Arch-Linux-+-Hyprland-Desktop. Ein Leistensymbol, ein Panel: ob dein Libre-WebUI-Server läuft, welche Version er ausführt, wie schnell er antwortet, und ein Ein-Klick-Start direkt in die App.
Das Plugin ist im Omarchy-Plugin-Marketplace verifiziert — von einem Marketplace-Maintainer genau beim veröffentlichten Commit geprüft.
- Marketplace-Eintrag: plugins.omarchy.org → Libre WebUI
- Quell-Repository: libre-webui/omarchy-libre-webui
Was es tut
- Status auf einen Blick — das Leistensymbol leuchtet auf, wenn dein Server ausfällt; das Panel zeigt Online/Offline, die laufende Version und die Antwortlatenz. Die Sonde nutzt den nicht authentifizierten Endpunkt
/health/live, sodass keine Zugangsdaten gespeichert werden und es sowohl gegen lokale als auch entfernte Server funktioniert. - Ein-Klick-Start — öffne Libre WebUI als rahmenloses Web-App-Fenster (
omarchy-launch-webapp) oder als normalen Browser-Tab. Rechtsklick auf das Leistensymbol startet direkt. - Starten, wenn es down ist — konfiguriere einen optionalen Startbefehl (
systemctl --user start libre-webui,docker start libre-webui, …), und ein Start-Button erscheint, sobald der Server offline ist, mit schnellem erneutem Prüfen, bis er antwortet. - Tastatur zuerst — Enter öffnet die App,
Raktualisiert, Pfeiltasten und Escape verhalten sich wie in jedem anderen Omarchy-Panel.
Installation
omarchy plugin add https://github.com/libre-webui/omarchy-libre-webui.git --enable
Füge dann das Widget über die Leisteneinstellungen zu deiner Leiste hinzu. Hast du Libre WebUI noch nicht? Ein Befehl genügt:
npx libre-webui@latest
und die Standard-Server-URL des Widgets (http://localhost:8080) findet es sofort.
Einstellungen
| Einstellung | Standard | Zweck |
|---|---|---|
| Server-URL | http://localhost:8080 | Wo dein Libre-WebUI-Server läuft — lokal oder entfernt. |
| Aktualisierungsintervall | 30 s | Wie oft die Health-Sonde läuft. |
| Öffnen als | Web-App-Fenster | omarchy-launch-webapp-App-Fenster vs. xdg-open-Browser-Tab. |
| Startbefehl | (leer) | Optionaler Befehl, den der Start-Button ausführt, während der Server offline ist. |
Maus und IPC
| Aktion | Wirkung |
|---|---|
| Linksklick | Panel umschalten |
| Rechtsklick | Libre WebUI starten |
| Mittelklick | Jetzt aktualisieren |
Das Widget beantwortet Shell-IPC, sodass du in Hyprland Tasten binden kannst:
omarchy-shell shell toggle org.librewebui.companion
Weitere IPC-Verben: refresh, launch.
Entfernen
omarchy plugin remove org.librewebui.companion
Sicherheit
Das Plugin ist bewusst minimal gehalten: sein einziger Netzwerkzugriff ist die Health-Sonde gegen die von dir konfigurierte Server-URL, Antwortkörper sind bereits beim Erzeuger größenbegrenzt, und die URL wird nie in Shell-Text interpoliert. Die Sicherheitsprüfung des Marketplace deckte genau diese Eigenschaften ab; die vollständige Historie ist öffentlich im Repository und im Marketplace-Einreichungsthread.