Skip to content
Ironbar

Network-Manager

Displays the state of each network device managed by NetworkManager. Each device type will show an icon representing its current state (connected, acquiring, disconnected).

Configuration

Type: network_manager

NameTypeDefaultProfile?Description
icon_sizeinteger24NoSize to render icon at.
types_blackliststring[][]NoAny device with a type in this list will not be shown.
types_whiteliststring[][]NoIf not empty, only devices with a type in this list will be shown.
interface_blackliststring[][]NoAny device whose interface name is in this list will not be shown.
interface_whiteliststring[][]NoIf not empty, only devices whose interface name is in this list will be shown.
iconstringicon:network-wired-symbolicYesIcon for connected wired device.
use_default_profilesbooleantrueNoWhether default profiles should be used.

This module uses a compound threshold with 2-3 values for profiles:

  • type - device type
  • state - device connection state
  • signal_strength (optional, when type="wifi")

Information on the profiles system can be found here.

Device Types: The device types used in types_whitelist and types_blacklists are the same as those used by NetworkManager. You can find the type of the devices on your system by running nmcli device status in a terminal. The possible device types are: unknown, ethernet, wifi, bt, olpc_mesh, wimax, modem, infiniband, bond, vlan, adsl, bridge, generic, team, tun, ip_tunnel, macvlan, vxlan, veth, macsec, dummy, ppp, ovs_interface, ovs_port, ovs_bridge, wpan, six_lowpan, wireguard, wifi_p2p, vrf, loopback, hsr and ipvlan.

JSON
{
  "end": [
    {
      "type": "network_manager",
      "icon_size": 24,
      "types_blacklist": ["loopback", "bridge"],
      "profiles": {
        "wired_disconnected": {
          "when": { "type": "wired", "state": "disconnected" },
          "icon": "icon:network-wired-disconnected-symbolic"
        }
      }
    }
  ]
}
TOML
[[end]]
type = "network_manager"
icon_size = 24
types_blacklist = ["loopback", "bridge"]


[end.profiles.wired_disconnected]
when = { type = "wired", state = "disconnected" }
icon = "icon:network-wired-disconnected-symbolic"
YAML
end:
  - type: "network_manager"
    icon_size: 24
    types_blacklist:
      - loopback
      - bridge
    profiles:
      wired_disconnected:
        when:
          type: "wired"
          state: "disconnected"
        icon: "icon:network-wired-disconnected-symbolic"
Corn 
{
  end = [
    {
      type = "network_manager"
      icon_size = 24
      types_blacklist = [ "loopback" "bridge" ]
      profiles = {
        wired_disconnected = {
          when = { type = "wired" state = "disconnected" }
          icon = "icon:network-wired-disconnected-symbolic"
        }
      }
    }
  ]
}

Default profiles

Show 
{
    wired_disconnected = {
        when = { type = "wired" state = "disconnected" }
        icon = ""
    }
    wired_acquiring = {
        when = { type = "wired" state = "acquiring" }
        icon = "icon:network-wired-acquiring-symbolic"
    }
    wired_connected = {
        when = { type = "wired" state = "connected" }
        icon = "icon:network-wired-symbolic"
    }
    wifi_disconnected = {
        when = { type = "wifi" state = "disconnected" }
        icon = ""
    }
    wifi_acquiring = {
        when = { type = "wifi" state = "acquiring" }
        icon = "icon:network-wireless-acquiring-symbolic"
    }
    wifi_connected_none = {
        when = { type = "wifi" state = "connected" signal_strength = 20 }
        icon = "icon:network-wireless-signal-none-symbolic"
    }
    wifi_connected_weak = {
        when = { type = "wifi" state = "connected" signal_strength = 40 }
        icon = "icon:network-wireless-signal-weak-symbolic"
    }
    wifi_connected_ok = {
        when = { type = "wifi" state = "connected" signal_strength = 50 }
        icon = "icon:network-wireless-signal-ok-symbolic"
    }
    wifi_connected_good = {
        when = { type = "wifi" state = "connected" signal_strength = 80 }
        icon = "icon:network-wireless-signal-good-symbolic"
    }
    wifi_connected_excellent = {
        when = { type = "wifi" state = "connected" signal_strength = 100 }
        icon = "icon:network-wireless-signal-excellent-symbolic"
    }
    cellular_disconnected = {
        when = { type = "cellular" state = "disconnected" }
        icon = ""
    }
    cellular_acquiring = {
        when = { type = "cellular" state = "acquiring" }
        icon = "icon:network-cellular-acquiring-symbolic"
    }
    cellular_connected = {
        when = { type = "cellular" state = "connected" }
        icon = "icon:network-cellular-connected-symbolic"
    }
    vpn_disconnected = {
        when = { type = "vpn" state = "disconnected" }
        icon = ""
    }
    vpn_acquiring = {
        when = { type = "vpn" state = "acquiring" }
        icon = "icon:network-vpn-acquiring-symbolic"
    }
    vpn_connected = {
        when = { type = "vpn" state = "connected" }
        icon = "icon:network-vpn-symbolic"
    }
    unknown = {
        when = { type = "unknown" }
        icon = "icon:dialog-question-symbolic"
    }


}

Styling

SelectorDescription
.network_managerNetworkManager widget container.
.network_manager .iconNetworkManager widget icons.

For more information on styling, please see the styling guide.