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.
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-disconnected	string		This format is used when the displayed interface is disconnected.
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.

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