Omahub
← All plugins
D

kvn TUI VPN

by Dmitry Yarikov

Native Omarchy bar integration for kvn, a terminal VPN client for Arch Linux.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
b0544e7
Scanned
1 day 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

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
b0544e7
Reviewed
1 day ago

The plugin is a straightforward Omarchy bar widget that talks to the kvn-tui daemon over a local Unix socket via a small, readable Python bridge. All external commands (starting the user systemd service, opening the install page, launching the TUI) are user-initiated and scoped to the intended VPN functionality. No obfuscation, persistence, credential theft, or destructive behavior was found.

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/yarikov/omakvn --enable
Widgets #bar #quickshell #security

omakvn

Native Omarchy bar integration for kvn, a terminal VPN client for Arch Linux.

omakvn preview

omakvn brings everyday VPN controls to the Omarchy bar — connect and switch profiles, change routing, monitor traffic, and control the kill switch without opening the full TUI.

For VPN setup, profiles, routing, DNS, and other features, see the kvn documentation.

Installation

kvn must be installed first.

Install the full Omarchy integration with:

kvn setup --omarchy

This installs omakvn together with the Apps menu entry, Hyprland shortcuts, and floating-window rules.

To install only the bar plugin:

omarchy plugin add https://github.com/yarikov/omakvn.git --enable

Update

omarchy plugin update yarikov.omakvn

Remove

omarchy plugin remove yarikov.omakvn

Usage

  • Left click — open the control panel
  • Right click — connect or disconnect
  • Middle click — open kvn

Keybindings

Key Action
j / k, up/down Move between controls
gg / G Jump to the first or last control
Enter / Space Activate the selected control
h / l, left/right Change the selected routing mode or region
s Disconnect
r Reconnect
Shift+A Toggle auto-connect
Shift+K Toggle the kill switch
t Open the full TUI
Tab / Shift+Tab Switch between bar panels
Escape Close the panel

The panel can be used entirely with the keyboard or mouse.

Credits

The original Omarchy integration was contributed by Denis Chupritskiy.

License

MIT