Skip to main content
Network widgets provide real-time information about your network connectivity and performance.

​
Network status

Displays one of three states: offline, ethernet connected, or Wi-Fi connected with SSID.

​
Basic configuration

set -g @dracula-plugins "network"
By default, this widget only displays the Wi-Fi network if it provides internet access. To show networks without internet, configure custom hosts.

​
Options

​
@dracula-network-hosts
string
default:"google.com github.com example.com"
Space-separated list of hosts to ping for checking connectivity. Use local IP addresses to detect networks without internet access.
​
@dracula-network-wifi-label
string
default:""
Label shown before Wi-Fi SSID.
​
@dracula-network-ethernet-label
string
default:"Ethernet"
Label shown for ethernet connections.
​
@dracula-network-offline-label
string
default:"Offline"
Label shown when no connection is available.

​
Label examples

# Nerd Font icons
set -g @dracula-network-wifi-label " "
set -g @dracula-network-ethernet-label "󰈀 Eth"
set -g @dracula-network-offline-label "󱍢 "

# Other icon options:
# Ethernet: 󰈀 󰒪 󰒍 󰌗 󰌘
# Offline: 󰖪  󱍢
# Wi-Fi:      󰖩  󰘊 󰒢

​
Usage examples

# Default (requires internet)
set -g @dracula-plugins "network"

# Show local networks without internet
set -g @dracula-network-hosts "192.168.1.1 10.0.0.1"

# Icon-based display
set -g @dracula-network-wifi-label " "
set -g @dracula-network-ethernet-label "󰈀 "
set -g @dracula-network-offline-label "󱍢 "

​
Known issues

If the iw command is only in root’s PATH and not available to regular users, Wi-Fi connections may be incorrectly identified as ethernet connections.

​
Network bandwidth

Displays current upload and download speeds per second for a specific network interface.

​
Basic configuration

set -g @dracula-plugins "network-bandwidth"

​
Options

​
@dracula-network-bandwidth
string
default:"auto"
Network interface to monitor (e.g., “eth0”, “wlan0”, “eno0”). Common interfaces: eth0 for wired, wlan0 for wireless.
​
@dracula-network-bandwidth-show-interface
boolean
default:"false"
Display the interface name alongside the speeds.
​
@dracula-network-bandwidth-interval
number
default:"0"
Update interval in seconds. Default (0) checks as frequently as possible.

​
Usage examples

# Monitor specific interface
set -g @dracula-plugins "network-bandwidth"
set -g @dracula-network-bandwidth "wlan0"

# Show interface name with speeds
set -g @dracula-network-bandwidth-show-interface true

# Update every 5 seconds
set -g @dracula-network-bandwidth-interval 5
Use ip link show or ifconfig to list available network interfaces on your system.

​
Public IP address

Displays your public IP address by querying ifconfig.me.

​
Basic configuration

set -g @dracula-plugins "network-public-ip"

​
Options

​
@dracula-network-public-ip-label
string
default:""
Label displayed before the public IP address.

​
Label examples

# Nerd Font icon
set -g @dracula-network-public-ip-label "󰖟 "

​
Usage examples

# Display public IP
set -g @dracula-plugins "network-public-ip"

# With custom label
set -g @dracula-network-public-ip-label "󰖟 "
This widget makes an external HTTP request to ifconfig.me. It respects your refresh rate setting to avoid excessive requests.

​
Network ping

Displays current ping latency to a specific server.

​
Basic configuration

set -g @dracula-plugins "network-ping"

​
Options

​
@dracula-ping-server
string
default:"google.com"
Server hostname or IP address to ping.
​
@dracula-ping-rate
number
default:"5"
How often to send ping requests (in seconds).

​
Usage examples

# Ping default server (google.com)
set -g @dracula-plugins "network-ping"

# Ping custom server every 3 seconds
set -g @dracula-ping-server "1.1.1.1"
set -g @dracula-ping-rate 3

# Monitor local network gateway
set -g @dracula-ping-server "192.168.1.1"

​
VPN status

Displays whether a VPN connection is active. Fully supports Tailscale exit nodes on Linux and macOS.

​
Basic configuration

set -g @dracula-plugins "network-vpn"

​
Options

​
@dracula-network-vpn-label
string
default:""
Label displayed before VPN information.
​
@dracula-network-vpn-verbose
boolean
default:"false"
Show the VPN’s IP address or Tailscale exit node name.

​
Label examples

# Nerd Font icon
set -g @dracula-network-vpn-label "󰌘 "

​
Usage examples

# Simple VPN status indicator
set -g @dracula-plugins "network-vpn"
set -g @dracula-network-vpn-label "󰌘 "

# Show VPN details
set -g @dracula-network-vpn-verbose true

​
Supported VPN types

  • Standard VPN connections (detected via network interfaces)
  • Tailscale exit nodes (Linux and macOS)
  • Most common VPN protocols (OpenVPN, WireGuard, etc.)

​
Complete example

# Comprehensive network monitoring
set -g @dracula-plugins "network network-bandwidth network-ping network-vpn"

# Customize network status labels
set -g @dracula-network-wifi-label " "
set -g @dracula-network-ethernet-label "󰈀 "
set -g @dracula-network-offline-label "󱍢 "

# Configure bandwidth monitoring
set -g @dracula-network-bandwidth "wlan0"
set -g @dracula-network-bandwidth-show-interface true
set -g @dracula-network-bandwidth-interval 2

# Configure ping monitoring
set -g @dracula-ping-server "1.1.1.1"
set -g @dracula-ping-rate 5

# Configure VPN monitoring
set -g @dracula-network-vpn-label "󰌘 "
set -g @dracula-network-vpn-verbose true

# Customize colors
set -g @dracula-network-colors "cyan dark_gray"
set -g @dracula-network-bandwidth-colors "pink dark_gray"
set -g @dracula-network-ping-colors "green dark_gray"
set -g @dracula-network-vpn-colors "orange dark_gray"

Build docs developers (and LLMs) love

Get started for freeTalk to us