Omahub
← All plugins
L

WayVNC

by Leonardo Marinovic

Shows wayvnc status in the bar and lets you start/stop it with a click

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
ee6839b
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
ee6839b
Reviewed
1 month ago

This plugin is a straightforward bar widget that toggles and monitors wayvnc using only the expected wayvnc/wayvncctl binaries. It contains no network calls, shell injection, or suspicious behavior. The deterministic scan flagged nothing, and the QML code matches its descriptions exactly.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/LeonardoM011/omarchy-wayvnc --enable
Widgets #system

omarchy-wayvnc

A bar widget for Omarchy that shows whether wayvnc is running, lists connected VNC clients, and lets you start, stop, or disconnect them — no terminal required.

Claude code was heavily used in making of this plugin!

<img src="preview.png" alt="The WayVNC popup panel, showing status and a Start wayvnc button" width="456">

Features

  • One icon in the bar: dimmed when wayvnc is stopped, highlighted in your theme's accent color when it's running.
  • Click opens a popup with the current status, the list of connected VNC clients (address, with a disconnect button per client), and a Start/Stop button.
  • Right-click skips the popup and toggles wayvnc directly — starts wayvnc or gracefully stops it with wayvncctl wayvnc-exit.
  • Status and the client list are polled from wayvnc's own control socket every 5 seconds, so both stay correct even if wayvnc was started, stopped, or connected to from outside the widget — another terminal, wayvncctl, or a crash.
  • Desktop notification on start/stop.
  • Scriptable over Omarchy's IPC: 
    omarchy-shell leonardom011.wayvnc status   # running | stopped
omarchy-shell leonardom011.wayvnc start
omarchy-shell leonardom011.wayvnc stop
omarchy-shell leonardom011.wayvnc toggle
omarchy-shell leonardom011.wayvnc panel    # open/close the popup

Requirements

  • wayvnc installed and on PATH (wayvncctl ships alongside it).
  • A working ~/.config/wayvnc/config (address, port, TLS certs, auth). This widget runs plain wayvnc with no arguments, so it always uses whatever config you already have — it does not manage or generate one for you.

Install

omarchy plugin add https://github.com/leonardom011/omarchy-wayvnc.git
omarchy plugin enable leonardom011.wayvnc

Plugins land disabled so you can read the code before it runs — it runs unsandboxed inside omarchy-shell, like every Omarchy plugin. Setup › Plugins does the same thing from the menu.

The icon appears at the right end of the bar by default. Move it with:

omarchy bar move leonardom011.wayvnc --section right

Uninstall

omarchy plugin remove leonardom011.wayvnc

This only removes the bar widget. If wayvnc happens to be running at the time, stop it first (click the icon or wayvncctl wayvnc-exit) — removing the widget does not kill an already-running wayvnc process.

Notes

  • This is a manual toggle, not a service manager. wayvnc is launched detached from omarchy-shell, so it keeps running across omarchy restart shell — but it will not auto-start on login or auto-restart after a reboot or crash. Wire it into a systemd user service if you want that.
  • Runs unsandboxed like any Omarchy plugin. It only ever calls wayvnc and wayvncctl — read BarWidget.qml before enabling if you want to verify that yourself.

License

MIT — see LICENSE.