Plugin de Omarchy
Libre WebUI incluye un plugin oficial para Omarchy, el escritorio Arch Linux + Hyprland con opiniones firmes. Un icono en la barra, un panel: si tu servidor Libre WebUI está activo, qué versión ejecuta, con qué rapidez responde, y un lanzamiento de la aplicación con un clic.
El plugin está verificado en el marketplace de plugins de Omarchy — revisado por un mantenedor del marketplace en el commit exacto publicado.
- Listado en el marketplace: plugins.omarchy.org → Libre WebUI
- Repositorio de código fuente: libre-webui/omarchy-libre-webui
Qué hace
- Estado de un vistazo — el icono de la barra se ilumina cuando tu servidor cae; el panel muestra en línea/fuera de línea, la versión en ejecución y la latencia de respuesta. La comprobación usa el endpoint sin autenticación
/health/live, así que no se almacenan credenciales y funciona igual con servidores locales y remotos. - Lanzamiento con un clic — abre Libre WebUI como una ventana de aplicación web sin bordes (
omarchy-launch-webapp) o como una pestaña normal del navegador. Haz clic derecho en el icono de la barra para lanzarlo directamente. - Inícialo cuando esté caído — configura un comando de inicio opcional (
systemctl --user start libre-webui,docker start libre-webui, …) y aparecerá un botón Start siempre que el servidor esté fuera de línea, con comprobaciones rápidas repetidas hasta que responda. - Pensado para el teclado — Enter abre la aplicación,
Ractualiza, y las flechas y Escape se comportan como en cualquier otro panel de Omarchy.
Instalación
omarchy plugin add https://github.com/libre-webui/omarchy-libre-webui.git --enable
Después añade el widget a tu barra desde los ajustes de la barra. ¿Todavía no tienes Libre WebUI? Un solo comando:
npx libre-webui@latest
y la URL de servidor predeterminada del widget (http://localhost:8080) lo encuentra de inmediato.
Configuración
| Ajuste | Predeterminado | Finalidad |
|---|---|---|
| URL del servidor | http://localhost:8080 | Dónde vive tu servidor Libre WebUI — local o remoto. |
| Intervalo de actualización | 30 s | Con qué frecuencia se ejecuta la comprobación de salud. |
| Abrir como | Web app window | Ventana de aplicación omarchy-launch-webapp frente a pestaña de navegador xdg-open. |
| Comando de inicio | (vacío) | Comando opcional que ejecuta el botón Start mientras el servidor está fuera de línea. |
Ratón e IPC
| Acción | Efecto |
|---|---|
| Clic izquierdo | Alternar el panel |
| Clic derecho | Lanzar Libre WebUI |
| Clic central | Actualizar ahora |
El widget responde a IPC de shell, así que puedes asignar teclas en Hyprland:
omarchy-shell shell toggle org.librewebui.companion
Verbos IPC adicionales: refresh, launch.
Eliminar
omarchy plugin remove org.librewebui.companion
Seguridad
El plugin es deliberadamente mínimo: su único acceso de red es la comprobación de salud contra la URL de servidor que configuras, los cuerpos de respuesta tienen un límite de tamaño en el productor, y la URL nunca se interpola en texto de shell. La revisión de seguridad del marketplace cubrió exactamente estas propiedades; el historial completo es público en el repositorio y en el hilo de envío del marketplace.