Plugin Omarchy
Libre WebUI include un plugin ufficiale per Omarchy, il desktop Arch Linux + Hyprland dalle opinioni marcate. Un'icona nella barra, un pannello: se il tuo server Libre WebUI è attivo, quale versione esegue, quanto velocemente risponde e un avvio a un clic dentro l'app.
Il plugin è verificato sul marketplace dei plugin di Omarchy — revisionato da un manutentore del marketplace esattamente al commit pubblicato.
- Scheda nel marketplace: plugins.omarchy.org → Libre WebUI
- Repository sorgente: libre-webui/omarchy-libre-webui
Cosa fa
- Stato a colpo d'occhio — l'icona nella barra si accende quando il server è offline; il pannello mostra online/offline, la versione in esecuzione e la latenza di risposta. Il probe usa l'endpoint
/health/live, che non richiede autenticazione, quindi non vengono memorizzate credenziali e funziona sia con server locali sia remoti. - Avvio a un clic — apri Libre WebUI come finestra web-app senza cornice (
omarchy-launch-webapp) oppure come normale scheda del browser. Clic destro sull'icona della barra per avviare direttamente. - Avvialo quando è offline — configura un comando di avvio opzionale (
systemctl --user start libre-webui,docker start libre-webui, …) e un pulsante Start compare ogni volta che il server è offline, con un nuovo probe rapido finché non risponde. - Pensato per la tastiera — Invio apre l'app,
Raggiorna, le frecce ed Esc si comportano come in ogni altro pannello di Omarchy.
Installazione
omarchy plugin add https://github.com/libre-webui/omarchy-libre-webui.git --enable
Poi aggiungi il widget alla barra dalle impostazioni della barra. Non hai ancora Libre WebUI? Un comando:
npx libre-webui@latest
e l'URL del server predefinito del widget (http://localhost:8080) lo trova subito.
Impostazioni
| Impostazione | Predefinito | Scopo |
|---|---|---|
| Server URL | http://localhost:8080 | Dove si trova il tuo server Libre WebUI — locale o remoto. |
| Refresh interval | 30 s | Ogni quanto viene eseguito il probe di integrità. |
| Open as | Web app window | Finestra app omarchy-launch-webapp contro scheda del browser xdg-open. |
| Start command | (empty) | Comando opzionale eseguito dal pulsante Start mentre il server è offline. |
Mouse e IPC
| Azione | Effetto |
|---|---|
| Clic sinistro | Attiva/disattiva il pannello |
| Clic destro | Avvia Libre WebUI |
| Clic centrale | Aggiorna subito |
Il widget risponde all'IPC della shell, quindi puoi associare tasti in Hyprland:
omarchy-shell shell toggle org.librewebui.companion
Verbi IPC aggiuntivi: refresh, launch.
Rimozione
omarchy plugin remove org.librewebui.companion
Sicurezza
Il plugin è volutamente minimale: il suo unico accesso di rete è il probe di integrità verso l'URL del server che configuri, i corpi delle risposte hanno un limite di dimensione imposto lato produttore e l'URL non viene mai interpolato in testo di shell. La revisione di sicurezza del marketplace ha coperto esattamente queste proprietà; la cronologia completa è pubblica nel repository e nel thread di invio al marketplace.