Skip to content
NoctaliaNoctaliadocs

    FAQnoctalia.dev

    network

    Shows the current network connection (Wi-Fi SSID and signal, wired, or cellular operator and signal) via NetworkManager. Disconnected and disabled states use the appropriate status glyph without dimming the widget. Left-click opens the Network tab in the control center; right-click disables or reconnects the active Wi-Fi, wired, or cellular connection.

    Hovering the widget shows a tooltip with the network name, signal strength, radio band, and interface. The band row (2.4 GHz, 5 GHz, 6 GHz, or 60 GHz) appears only when the backend reports the connection frequency: NetworkManager and wpa_supplicant do, iwd does not.

    When a cellular connection is the active one, the glyph shows live ModemManager signal bars and the label shows the operator name. An enabled modem that is not the active connection contributes extra tooltip rows (state, operator, signal, technology) instead; a powered-off modem is not shown. Cellular status requires ModemManager and is configured from the control center’s Cellular card.

    SettingTypeDefaultDescription
    show_labelbooltrueShow the SSID or interface name next to the glyph
    vpn_statusstring"replace"VPN indicator mode: "replace" swaps the network glyph for a shield, "both" shows both glyphs, and "hidden" disables the indicator.
    show_vpn_labelboolfalseShow the VPN name when vpn_status is "replace" or "both" and labels are enabled.
    [widget.network]
    show_label = false