Module net

Expand description

Network information

This block uses sysfs and netlink and thus does not require any external dependencies.

§Configuration

Key	Values	Default
`device`	Network interface to monitor (as specified in `/sys/class/net/`). Supports regex.	If not set, device will be automatically selected every `interval`
`interval`	Update interval in seconds	`2`
`format`	A string to customise the output of this block. See below for available placeholders.	`" $icon ^icon_net_down $speed_down.eng(prefix:K) ^icon_net_up $speed_up.eng(prefix:K) "`
`format_alt`	If set, block will switch between `format` and `format_alt` on every click	`None`
`inactive_format`	Same as `format` but for when the interface is inactive	`" $icon Down "`
`missing_format`	Same as `format` but for when the device is missing	`" × "`

Action	Description	Default button
`toggle_format`	Toggles between `format` and `format_alt`	Left

Placeholder	Value	Type	Unit
`icon`	Icon based on device’s type	Icon	-
`speed_down`	Download speed	Number	Bytes per second
`speed_up`	Upload speed	Number	Bytes per second
`graph_down`	Download speed graph	Text	-
`graph_up`	Upload speed graph	Text	-
`device`	The name of device	Text	-
`ssid`	Netfork SSID (WiFi only)	Text	-
`frequency`	WiFi frequency	Number	Hz
`signal_strength`	WiFi signal	Number	%
`bitrate`	WiFi connection bitrate	Number	Bits per second
`ip`	IPv4 address of the iface	Text	-
`ipv6`	IPv6 address of the iface	Text	-
`nameserver`	Nameserver	Text	-

Display WiFi info if available

[[block]]
block = "net"
format = " $icon {$signal_strength $ssid $frequency|Wired connection} via $device "

Display exact device

[[block]]
block = "net"
device = "^wlo0$"