Module: Network

The network module displays information about the current network connections.

Config

Addressed by network

option	typeof	default	description
interface	string		Use the defined interface instead of auto detection. Accept wildcard.
interval	integer	60	The interval in which the network information gets polled (e.g. signal strength).
format	string	{ifname}	The format, how information should be displayed. This format is used when other formats aren't specified.
format-ethernet	string		This format is used when a ethernet interface is displayed.
format-wifi	string		This format is used when a wireless interface is displayed.
format-linked	string		This format is used when a linked interface with no ip address is displayed.
format-disconnected	string		This format is used when the displayed interface is disconnected.
rotate	integer		Positive value to rotate the text label.
max-length	integer		The maximum length in character the module should display.
on-click	string		Command to execute when clicked on the module.
on-click-right	string		Command to execute when you right clicked on the module.
on-scroll-up	string		Command to execute when scrolling up on the module.
on-scroll-down	string		Command to execute when scrolling down on the module.
tooltip	bool	true	Option to disable tooltip on hover.
tooltip-format	string		The format, how information should be displayed in the tooltip. This format is used when other formats aren't specified.
tooltip-format-ethernet	string		This format is used when a ethernet interface is displayed.
tooltip-format-wifi	string		This format is used when a wireless interface is displayed.
tooltip-format-disconnected	string		This format is used when the displayed interface is disconnected.

Format replacements:

string	replacement
{ifname}	Name of the network interface.
{ipaddr}	The first IP of the interface.
{netmask}	The subnetmask corresponding to the IP.
{cidr}	The subnetmask corresponding to the IP in CIDR notation.
{essid}	Name (SSID) of the wireless network.
{signalStrength}	Signal strenth of the wireless network.
{signaldBm}	Signal strenth of the wireless network in dBm.
{frequency}	Frequency of the wireless network in MHz.
{bandwidthUpBits}	Instant up speed in bits/seconds.
{bandwidthDownBits}	Instant down speed in bits/seconds.
{bandwidthUpOctets}	Instant up speed in octets/seconds.
{bandwidthDownOctets}	Instant down speed in octets/seconds.

Example:

"network": {
    "interface": "wlp2s0",
    "format": "{ifname}",
    "format-wifi": "{essid} ({signalStrength}%) ",
    "format-ethernet": "{ifname} ",
    "format-disconnected": "", //An empty format will hide the module.
    "tooltip-format": "{ifname}",
    "tooltip-format-wifi": "{essid} ({signalStrength}%) ",
    "tooltip-format-ethernet": "{ifname} ",
    "tooltip-format-disconnected": "Disconnected",
    "max-length": 50
}

Style

• #network
• #network.disconnected