Skip to content

WireGuard Widget

Control a macOS Network Extension VPN service with scutil.

easybar widgets install wireguard
Package metadata Value
Name wireguard
Version 0.1.0
Kind widget
Minimum EasyBar 0.41.0
License Apache-2.0
Categories network, system
Dependencies shared ^0.1.0
Required commands scutil

View package source

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.