Omarchy プラグイン
Libre WebUI は、Arch Linux + Hyprland による独自の思想を持つデスクトップ Omarchy 向けの公式プラグインを提供しています。バーアイコン 1 つ、パネル 1 つで、Libre WebUI サーバーが稼働しているか、どのバージョンを実行しているか、応答速度はどうか、そしてアプリへのワンクリック起動までを確認できます。
このプラグインは Omarchy プラグインマーケットプレイスで検証済み です。マーケットプレイスのメンテナーが、公開された正確なコミットでレビューしています。
- マーケットプレイス掲載ページ: plugins.omarchy.org → Libre WebUI
- ソースリポジトリ: libre-webui/omarchy-libre-webui
できること
- ひと目でわかる状態表示 — サーバーが落ちるとバーアイコンが点灯します。パネルにはオンライン／オフラインの状態、実行中のバージョン、応答レイテンシが表示されます。プローブは認証不要の
/health/liveエンドポイントを使うため、資格情報は一切保存されず、ローカルサーバーとリモートサーバーの両方で同様に動作します。 - ワンクリック起動 — Libre WebUI を枠なしの web-app ウィンドウ（
omarchy-launch-webapp）、または通常のブラウザータブとして開きます。バーアイコンを右クリックすると直接起動できます。 - 停止中のサーバーを起動 — 任意の起動コマンド（
systemctl --user start libre-webui、docker start libre-webuiなど）を設定すると、サーバーがオフラインのときに Start ボタンが表示され、応答するまで高速に再プローブします。 - キーボード優先の操作 — Enter でアプリを開き、
Rで更新し、矢印キーと Escape は他の Omarchy パネルと同じように動作します。
インストール
omarchy plugin add https://github.com/libre-webui/omarchy-libre-webui.git --enable
その後、バー設定からウィジェットをバーに追加してください。まだ Libre WebUI をお持ちでない場合は、コマンド 1 つで用意できます。
npx libre-webui@latest
ウィジェットの既定のサーバー URL（http://localhost:8080）がすぐにそれを見つけます。
設定
| 設定 | 既定値 | 用途 |
|---|---|---|
| Server URL | http://localhost:8080 | Libre WebUI サーバーの場所 — ローカルまたはリモート。 |
| Refresh interval | 30 s | ヘルスプローブを実行する頻度。 |
| Open as | Web app window | omarchy-launch-webapp によるアプリウィンドウか xdg-open によるブラウザータブか。 |
| Start command | (empty) | サーバーがオフラインの間に Start ボタンが実行する任意のコマンド。 |
マウスと IPC
| 操作 | 効果 |
|---|---|
| 左クリック | パネルの表示切り替え |
| 右クリック | Libre WebUI を起動 |
| 中クリック | 今すぐ更新 |
このウィジェットはシェル IPC に応答するため、Hyprland でキーを割り当てられます。
omarchy-shell shell toggle org.librewebui.companion
追加の IPC 動詞: refresh、launch。
削除
omarchy plugin remove org.librewebui.companion
セキュリティ
このプラグインは意図的に最小限に作られています。ネットワークアクセスは、設定したサーバー URL に対するヘルスプローブのみで、レスポンスボディは送信元でサイズ上限が設けられており、URL がシェルのテキストに埋め込まれることは決してありません。マーケットプレイスのセキュリティレビューは、まさにこれらの特性を対象としました。詳しい経緯は リポジトリ とマーケットプレイス申請スレッドで公開されています。