WireGuard Widget¶
Control a macOS Network Extension VPN service with scutil.
Install for EasyBar:
easybar widgets install wireguard
Install for EasyBar Native:
easybar-native widgets install wireguard
| Package metadata | Value |
|---|---|
| Name | wireguard |
| Version | 0.1.5 |
| Kind | widget |
| Minimum EasyBarKit | 0.1.0 |
| License | Apache-2.0 |
| Categories | network, system |
| Dependencies | shared ^0.2.1 |
| Required commands | scutil |
Package documentation¶
widget.lua controls a macOS Network Extension VPN service through scutil --nc. The service name is read from EasyBar's widget configuration.
Configuration¶
Set the exact service name shown by scutil --nc list:
[widgets.wireguard]
vpn_name = "WireGuard"
The default is WireGuard. Reload the configuration after changing the value:
easybar config reload
Behavior¶
- left click starts or stops the configured service
- the popup shows the configured VPN name and current status
- network and forced-refresh events update the state
This example controls a Network Extension service. It does not invoke wg-quick or infer a tunnel name from an interface.