Omarchy 플러그인
Libre WebUI는 opinionated한 Arch Linux + Hyprland 데스크톱인 Omarchy용 공식 플러그인을 제공합니다. 바 아이콘 하나, 패널 하나로 Libre WebUI 서버가 살아 있는지, 어떤 버전을 실행 중인지, 응답 속도는 얼마나 빠른지 확인하고, 원클릭으로 앱을 실행할 수 있습니다.
이 플러그인은 Omarchy 플러그인 마켓플레이스에서 검증되었습니다 — 마켓플레이스 메인테이너가 정확히 게시된 커밋에서 리뷰했습니다.
- 마켓플레이스 등록 페이지: plugins.omarchy.org → Libre WebUI
- 소스 저장소: libre-webui/omarchy-libre-webui
기능
- 한눈에 보는 상태 — 서버가 다운되면 바 아이콘이 표시되고, 패널에는 온라인/오프라인 여부, 실행 중인 버전, 응답 지연 시간이 나타납니다. 인증이 필요 없는
/health/live엔드포인트로 확인하므로 자격 증명을 저장하지 않으며 로컬 서버와 원격 서버 모두에서 동작합니다. - 원클릭 실행 — Libre WebUI를 크롬 없는 웹 앱 창(
omarchy-launch-webapp)으로 열거나 일반 브라우저 탭으로 엽니다. 바 아이콘을 우클릭하면 바로 실행됩니다. - 다운되었을 때 시작하기 — 선택적으로 시작 명령(
systemctl --user start libre-webui,docker start libre-webui등)을 설정하면, 서버가 오프라인일 때마다 시작 버튼이 나타나고 응답할 때까지 빠르게 재확인합니다. - 키보드 우선 — Enter로 앱을 열고,
R로 새로고침하며, 방향키와 Escape는 다른 모든 Omarchy 패널과 동일하게 동작합니다.
설치
omarchy plugin add https://github.com/libre-webui/omarchy-libre-webui.git --enable
이후 바 설정에서 위젯을 바에 추가하세요. 아직 Libre WebUI가 없다면 명령 하나면 됩니다.
npx libre-webui@latest
그러면 위젯의 기본 서버 URL(http://localhost:8080)이 즉시 이를 찾아냅니다.
설정
| 설정 | 기본값 | 용도 |
|---|---|---|
| 서버 URL | http://localhost:8080 | Libre WebUI 서버 위치 — 로컬 또는 원격. |
| 새로고침 간격 | 30초 | 헬스 체크를 실행하는 주기. |
| 실행 방식 | 웹 앱 창 | omarchy-launch-webapp 앱 창 대 xdg-open 브라우저 탭. |
| 시작 명령 | (비어 있음) | 서버가 오프라인일 때 시작 버튼이 실행할 선택적 명령. |
마우스와 IPC
| 동작 | 효과 |
|---|---|
| 좌클릭 | 패널 전환 |
| 우클릭 | Libre WebUI 실행 |
| 휠클릭 | 즉시 새로고침 |
위젯은 셸 IPC에 응답하므로 Hyprland에서 키를 바인딩할 수 있습니다.
omarchy-shell shell toggle org.librewebui.companion
추가 IPC 동작: refresh, launch.
제거
omarchy plugin remove org.librewebui.companion
보안
플러그인은 의도적으로 최소한의 기능만 가집니다. 유일한 네트워크 접근은 설정한 서버 URL에 대한 헬스 체크뿐이며, 응답 본문은 생산 지점에서 크기가 제한되고, URL이 셸 텍스트에 삽입되는 일은 없습니다. 마켓플레이스의 보안 리뷰는 정확히 이러한 속성을 대상으로 했으며, 전체 이력은 저장소와 마켓플레이스 제출 스레드에 공개되어 있습니다.