Aller au contenu principal

Plugin Omarchy

Libre WebUI fournit un plugin officiel pour Omarchy, le bureau Arch Linux + Hyprland aux choix affirmés. Une icône dans la barre, un panneau : si votre serveur Libre WebUI est actif, quelle version il exécute, avec quelle rapidité il répond, et un lancement de l’application en un clic.

Le plugin est vérifié sur le marketplace de plugins Omarchy — examiné par un mainteneur du marketplace au commit exact publié.

Ce qu’il fait

  • État en un coup d’œil — l’icône de la barre s’allume quand votre serveur tombe ; le panneau affiche en ligne/hors ligne, la version en cours d’exécution et la latence de réponse. La vérification utilise le point de terminaison non authentifié /health/live, donc aucun identifiant n’est stocké et cela fonctionne aussi bien pour les serveurs locaux que distants.
  • Lancement en un clic — ouvrez Libre WebUI comme une fenêtre d’application web sans bordure (omarchy-launch-webapp) ou comme un onglet de navigateur classique. Clic droit sur l’icône de la barre pour lancer directement.
  • Le démarrer quand il est arrêté — configurez une commande de démarrage optionnelle (systemctl --user start libre-webui, docker start libre-webui, …) et un bouton Start apparaît dès que le serveur est hors ligne, avec des nouvelles vérifications rapides jusqu’à ce qu’il réponde.
  • Pensé pour le clavier — Entrée ouvre l’application, R actualise, les flèches et Échap se comportent comme dans tout autre panneau Omarchy.

Installation

omarchy plugin add https://github.com/libre-webui/omarchy-libre-webui.git --enable

Ajoutez ensuite le widget à votre barre depuis les paramètres de la barre. Vous n’avez pas encore Libre WebUI ? Une seule commande :

npx libre-webui@latest

et l’URL de serveur par défaut du widget (http://localhost:8080) le trouve immédiatement.

Paramètres

ParamètreValeur par défautRôle
URL du serveurhttp://localhost:8080Où se trouve votre serveur Libre WebUI — local ou distant.
Intervalle d’actualisation30 sFréquence d’exécution de la vérification de santé.
Ouvrir en tant queWeb app windowFenêtre d’application omarchy-launch-webapp contre onglet de navigateur xdg-open.
Commande de démarrage(vide)Commande optionnelle exécutée par le bouton Start tant que le serveur est hors ligne.

Souris et IPC

ActionEffet
Clic gaucheBasculer le panneau
Clic droitLancer Libre WebUI
Clic centralActualiser maintenant

Le widget répond à l’IPC shell, vous pouvez donc lier des touches dans Hyprland :

omarchy-shell shell toggle org.librewebui.companion

Verbes IPC supplémentaires : refresh, launch.

Suppression

omarchy plugin remove org.librewebui.companion

Sécurité

Le plugin est volontairement minimal : son seul accès réseau est la vérification de santé contre l’URL de serveur que vous configurez, les corps de réponse ont une taille plafonnée à la source, et l’URL n’est jamais interpolée dans du texte shell. L’examen de sécurité du marketplace a couvert exactement ces propriétés ; l’historique complet est public dans le dépôt et dans le fil de soumission du marketplace.