JakeStanger · Rodrigodd · Sep 28, 2024 · Nov 11, 2025 · Nov 11, 2025 · Nov 11, 2025
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -93,7 +93,7 @@ music = []
 "music+mpris" = ["music", "mpris"]
 "music+mpd" = ["music", "mpd-utils"]
 
-network_manager = ["futures-lite", "futures-signals", "zbus"]
+network_manager = ["futures-lite", "zbus"]
 
 notifications = ["zbus"]
 
@@ -176,9 +176,6 @@ evdev-rs = { version = "0.6.3", optional = true }
 mpd-utils = { version = "0.2.1", optional = true }
 mpris = { version = "2.0.1", optional = true }
 
-# network_manager
-futures-signals = { version = "0.3.34", optional = true }
-
 # sys_info
 sysinfo = { version = "0.37.2", optional = true }
 

diff --git a/docs/modules/Network-Manager.md b/docs/modules/Network-Manager.md
@@ -1,80 +1,113 @@
-Displays the current network connection state of NetworkManager.
-Supports wired ethernet, wifi, cellular data and VPN connections among others.
-
-> [!NOTE]
-> This module is currently a basic skeleton implementation and only offers the most basic functionality currently. 
-> It uses NetworkManager's so-called primary connection, 
-> and therefore inherits its limitation of only being able to display the "top-level" connection.
-> For example, if we have a VPN connection over a wifi connection it will only display the former, 
-> until it is disconnected, at which point it will display the latter.
-> A solution to this is currently in the works.
+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`
-
-| Name        | Type      | Default | Description             |
-|-------------|-----------|---------|-------------------------|
-| `icon_size` | `integer` | `24`    | Size to render icon at. |
-
-> [!NOTE]
-> This module does not support module-level [layout options](module-level-options#layout).
+> Type: `networkmanager`
+
+| Name                          | Type       | Default                                    | Description                                                                         |
+| ----------------------------- | ---------- | ------------------------------------------ | ----------------------------------------------------------------------------------- |
+| `icon_size`                   | `integer`  | `24`                                       | Size to render icon at.                                                             |
+| `types_blacklist`             | `string[]` | `[]`                                       | Any device with a type in this list will not be shown.                              |
+| `types_whitelist`             | `string[]` | `[]`                                       | If not empty, only devices with a type in this list will be shown.                  |
+| `interface_blacklist`         | `string[]` | `[]`                                       | Any device whose interface name is in this list will not be shown.                  |
+| `interface_whitelist`         | `string[]` | `[]`                                       | If not empty, only devices whose interface name is in this list will be shown.      |
+| `icons.wired.connected`       | `string`   | `icon:network-wired-symbolic`              | Icon for connected wired device.                                                    |
+| `icons.wired.acquiring`       | `string`   | `icon:network-wired-acquiring-symbolic`    | Icon for acquiring wired device.                                                    |
+| `icons.wired.disconnected`    | `string`   | `""`                                       | Icon for disconnected wired device.                                                 |
+| `icons.wifi.levels`           | `string[]` | See below                                  | Icon for each strengh level of a connected wifi connection, from lowest to highest. |
+| `icons.wifi.acquiring`        | `string`   | `icon:network-wireless-acquiring-symbolic` | Icon for acquiring wifi device.                                                     |
+| `icons.wifi.disconnected`     | `string`   | `""`                                       | Icon for disconnected wifi connection.                                              |
+| `icons.cellular.connected`    | `string`   | `icon:network-cellular-connected-symbolic` | Icon for connected cellular device.                                                 |
+| `icons.cellular.acquiring`    | `string`   | `icon:network-cellular-acquiring-symbolic` | Icon for acquiring cellular device.                                                 |
+| `icons.cellular.disconnected` | `string`   | `""`                                       | Icon for disconnected cellular device.                                              |
+| `icons.vpn.connected`         | `string`   | `icon:network-vpn-symbolic`                | Icon for connected VPN device.                                                      |
+| `icons.vpn.acquiring`         | `string`   | `icon:network-vpn-acquiring-symbolic`      | Icon for acquiring VPN device.                                                      |
+| `icons.vpn.disconnected`      | `string`   | `""`                                       | Icon for disconnected VPN device.                                                   |
+| `unkown`                      | `string`   | `icon:dialog-question-symbolic`            | Icon for device in unkown state.                                                    |
+
+**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`.
+
+**Default `icons.wifi.levels`:** they contain the 5 GTK symbolic icons for wireless signal strength:
+- `"icon:network-wireless-signal-none-symbolic"`
+- `"icon:network-wireless-signal-weak-symbolic"`
+- `"icon:network-wireless-signal-ok-symbolic"`
+- `"icon:network-wireless-signal-good-symbolic"`
+- `"icon:network-wireless-signal-excellent-symbolic"`
 
 <details>
-  <summary>JSON</summary>
-
-  ```json
-  {
-    "end": [
-      {
-        "type": "network_manager",
-        "icon_size": 32
-      }
-    ]
-  }
-  ```
+<summary>JSON</summary>
+
+```json
+{
+  "end": [
+    {
+      "type": "networkmanager",
+      "icon_size": 24
+      types_blacklist: ["loopback", "bridge"]
+    }
+  ]
+}
+```
+
 </details>
 
 <details>
-  <summary>TOML</summary>
+<summary>TOML</summary>
+
+```toml
+[[end]]
+type = "networkmanager"
+icon_size = 24
+types_blacklist = ["loopback", "bridge"]
+```
 
-  ```toml
-  [[end]]
-  type = "network_manager"
-  icon_size = 32
-  ```
 </details>
 
 <details>
-  <summary>YAML</summary>
+<summary>YAML</summary>
+
+```yaml
+end:
+  - type: "networkmanager"
+    icon_size: 24
+    types_blacklist:
+      - loopback
+      - bridge
+```
 
-  ```yaml
-  end:
-    - type: "network_manager"
-      icon_size: 32
-  ```
 </details>
 
 <details>
-  <summary>Corn</summary>
-
-  ```corn
-  {
-    end = [
-      {
-        type = "network_manager"
-        icon_size = 32
-      }
-    ]
-  }
-  ```
+<summary>Corn</summary>
+
+```corn
+{
+  end = [
+    {
+      type = "networkmanager"
+      icon_size = 24
+      types_blacklist = ["loopback", "bridge"]
+    }
+  ]
+}
+```
+
 </details>
 
 ## Styling
 
-| Selector                 | Description                      |
-|--------------------------|----------------------------------|
-| `.network_manager`       | NetworkManager widget container. |
-| `.network_manager .icon` | NetworkManager widget icon.      |
+| Selector               | Description                      |
+| ---------------------- | -------------------------------- |
+| `.networkmanager`      | NetworkManager widget container. |
+| `.networkmanger .icon` | NetworkManager widget icons.     |
 
 For more information on styling, please see the [styling guide](styling-guide).