Module i3status_rs::blocks::net
source · 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 | - |
§Example
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$"
§Icons Used
net_loopbacknet_vpnnet_wirednet_wireless(as a progression)net_upnet_down