Plugin do Omarchy
O Libre WebUI oferece um plugin oficial para o Omarchy, o desktop opinativo baseado em Arch Linux + Hyprland. Um único ícone na barra, um único painel: se o seu servidor Libre WebUI está no ar, qual versão ele está executando, quão rápido ele responde, e um launcher com um clique para abrir o aplicativo.
O plugin é verificado no marketplace de plugins do Omarchy — revisado por um mantenedor do marketplace exatamente no commit publicado.
- Listagem no marketplace: plugins.omarchy.org → Libre WebUI
- Repositório de código-fonte: libre-webui/omarchy-libre-webui
O que ele faz
- Status em um relance — o ícone da barra acende quando o seu servidor fica fora do ar; o painel mostra online/offline, a versão em execução e a latência de resposta. A sondagem usa o endpoint não autenticado
/health/live, então nenhuma credencial é armazenada, e funciona tanto contra servidores locais quanto remotos. - Launcher com um clique — abra o Libre WebUI como uma janela de web-app sem moldura (
omarchy-launch-webapp) ou como uma aba de navegador comum. Clique com o botão direito no ícone da barra para abrir diretamente. - Inicie quando estiver fora do ar — configure um comando de inicialização opcional (
systemctl --user start libre-webui,docker start libre-webui, …) e um botão Start aparece sempre que o servidor estiver offline, com nova sondagem rápida até que ele responda. - Pensado para teclado — Enter abre o aplicativo,
Ratualiza, as setas e Escape se comportam como em qualquer outro painel do Omarchy.
Instalação
omarchy plugin add https://github.com/libre-webui/omarchy-libre-webui.git --enable
Depois, adicione o widget à sua barra pelas configurações de barra. Ainda não tem o Libre WebUI? Um comando resolve:
npx libre-webui@latest
e a URL padrão do servidor no widget (http://localhost:8080) o encontra imediatamente.
Configurações
| Configuração | Padrão | Finalidade |
|---|---|---|
| URL do servidor | http://localhost:8080 | Onde o seu servidor Libre WebUI está — local ou remoto. |
| Intervalo de atualização | 30 s | Com que frequência a sondagem de saúde é executada. |
| Abrir como | Janela de web-app | Janela de aplicativo via omarchy-launch-webapp versus aba de navegador via xdg-open. |
| Comando de inicialização | (vazio) | Comando opcional que o botão Start executa enquanto o servidor está offline. |
Mouse e IPC
| Ação | Efeito |
|---|---|
| Clique com o botão esquerdo | Alterna o painel |
| Clique com o botão direito | Abre o Libre WebUI |
| Clique com o botão do meio | Atualiza agora |
O widget responde a IPC de shell, então você pode vincular teclas no Hyprland:
omarchy-shell shell toggle org.librewebui.companion
Verbos de IPC adicionais: refresh, launch.
Remoção
omarchy plugin remove org.librewebui.companion
Segurança
O plugin é deliberadamente minimalista: seu único acesso de rede é a sondagem de saúde contra a URL de servidor que você configurar, os corpos de resposta têm tamanho limitado na origem, e a URL nunca é interpolada em texto de shell. A revisão de segurança do marketplace cobriu exatamente essas propriedades; o histórico completo é público no repositório e na thread de submissão ao marketplace.