libre-webui/omarchy-libre-webui
3
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
4 commits 1 branch 0 tags 491 KiB
  • QML 100%
Find a file
Exact
rob@kroonen.ai 024a26a10c Bound the health probe response size
2026-08-31 01:28:31 -04:00
assets Libre WebUI companion widget for the Omarchy bar 2026-08-30 11:03:54 -04:00
LICENSE Libre WebUI companion widget for the Omarchy bar 2026-08-30 11:03:54 -04:00
manifest.json Bound the health probe response size 2026-08-31 01:28:31 -04:00
Panel.qml Bound the health probe response size 2026-08-31 01:28:31 -04:00
preview.png Add marketplace preview 2026-08-30 11:21:22 -04:00
README.md Show preview in README 2026-08-30 11:21:43 -04:00

README.md

Libre WebUI for Omarchy

Libre WebUI server status, health, and launcher in the Omarchy bar — one icon, one panel.

Libre WebUI panel open on an Omarchy desktop

  • Status at a glance — the bar icon lights up when your server goes down; the panel shows online/offline, the running version, and response latency, probed from the unauthenticated /health/live endpoint (no credentials stored, works against local and remote servers alike).
  • One-click launch — open Libre WebUI as a chromeless web-app window (omarchy-launch-webapp) or a regular browser tab. Right-click the bar icon to launch directly.
  • Start it when it's down — configure an optional start command (systemctl --user start libre-webui, docker start libre-webui, …) and a Start button appears whenever the server is offline, with fast re-probing until it answers.
  • Keyboard-first — Enter opens the app, R refreshes, arrow keys and Escape behave like every other Omarchy panel.

Install

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

Then add the widget to your bar from the bar settings, or place it in ~/.config/omarchy/shell.json.

Don't have Libre WebUI yet? One command:

npx libre-webui@latest

and the widget's defaults (http://localhost:8080) find it immediately.

Settings

Setting Default Purpose
Server URL http://localhost:8080 Where your Libre WebUI server lives — local or remote.
Refresh interval 30 s How often the health probe runs.
Open as Web app window omarchy-launch-webapp app window vs xdg-open browser tab.
Start command (empty) Optional command the Start button runs while the server is offline. Empty hides the button.

Mouse and IPC

Action Effect
Left click Toggle the panel
Right click Launch Libre WebUI
Middle click Refresh now

The widget answers shell IPC, so you can bind keys in Hyprland:

omarchy-shell shell toggle org.librewebui.companion

Extra IPC verbs: refresh, launch.

Remove

omarchy plugin remove org.librewebui.companion

Development

git clone https://github.com/libre-webui/omarchy-libre-webui.git
omarchy plugin validate .
qmllint -I "$OMARCHY_PATH/shell" Panel.qml

The plugin is a single bar-widget (Panel.qml) following the same shape as Omarchy's first-party panels. Issues and PRs welcome.

License

Apache-2.0, same as Libre WebUI itself.