Skip to content
github-actions[bot] edited this page Jul 4, 2026 · 3 revisions

DESCRIPTION

wwan module for ModemManager.

ADDITIONAL FILES

libmm-glib lives in:

1.

/usr/lib/libmm-glib.so or /usr/lib64/libmm-glib.so

2.

/usr/lib/pkgconfig/libmm-glib.pc or /usr/lib64/pkgconfig/libmm-glib.pc

3.

/usr/include/libmm-glib

CONFIGURATION

format:
typeof: string
default: {state}
The format, how information should be displayed. This format is used when other formats aren't specified.

format-failed:
typeof: string
This format is used when the modem cannot start.

format-locked:
typeof: string
This format is used when the SIM on the modem is locked.

format-disabled:
typeof: string
This format is used when the modem is disabled.

format-enabled:
typeof: string
This format is used when the modem is enabled, but isn't registered to any carrier network.

format-searching:
typeof: string
This format is used when the modem is looking for a carrier network to register to.

format-registered:
typeof: string
This format is used when the modem is registered to a network, but no data connection is active.

format-connected:
typeof: string
This format is used when the modem is registered to a network, and there is an active data connection.

format-icons:
typeof: array/object
Based on the current signal strength, the corresponding icon gets selected.
The order is low to high. Or by the state if it is an object.

tooltip:
typeof: bool
default: true
Option to disable tooltip on hover.

tooltip-format:
typeof: strirng
default: {state}
The format, how information should be displayed in the tooltip. This format is used when other formats aren't specified.

tooltip-format-failed:
typeof: string
This format is used when the modem cannot start.

tooltip-format-locked:
typeof: string
This format is used when the SIM on the modem is locked.

tooltip-format-disabled:
typeof: string
This format is used when the modem is disabled.

tooltip-format-enabled:
typeof: string
This format is used when the modem is enabled, but isn't registered to any carrier network.

tooltip-format-searching:
typeof: string
This format is used when the modem is looking for a carrier network to register to.

tooltip-format-registered:
typeof: string
This format is used when the modem is registered to a network, but no data connection is active.

tooltip-format-connected:
typeof: string
This format is used when the modem is registered to a network, and there is an active data connection.

interval:
typeof: integer
default: 5
The interval in which the WWAN information gets polled (e.g. carrier name).

imei:
typeof: string
Select only the modem with the corresponding imei.

path:
typeof: string
Select only the modem with the corresponding hardware path.

hide-disconnected:
typeof: bool
default: true
Defines if the module should be hidden while the modem does not have an active data connection.

FORMAT REPLACEMENTS

{state}: Modem state.

{current_modes}: List of all the currently active connection modes.

{preferred_mode}: The preferred connection mode in use.

{signal_quality}: Signal quality (0-100).

{operator_name}: Name of the network operator.

{icon}: Icon selected from format-icons according to the signal quality.

{power_state}: Modem power state (On/Off/Low/Unknown).

{imei}: Modem equipment identifier (IMEI).

EXAMPLES

"wwan": {
	"format": "{state}",
	"format-disabled": "", // an empty format will hide the module
	"format-locked": "SIM Locked",
    "format-connected": "{operator_name} {preferred_mode} | {signal_quality}%"
	"tooltip-format": "{preferred_mode}",
	"tooltip-format-connected": "{current_modes}",
	"hide-disconnected": false
}

STYLE

·

#wwan

·

#wwan.failed Applied when the modem cannot start.

·

#wwan.locked Applied when the SIM on the modem is locked.

·

#wwan.disabled Applied when the modem is disabled.

·

#wwan.enabled Applied when the modem is enabled, but isn't registered to any carrier network.

·

#wwan.searching Applied when the modem is looking for a carrier network to register to.

·

#wwan.registered Applied when the modem is registered to a network, but no data connection is active.

·

#wwan.connected Applied when the modem is registered to a network, and there is an active data connection.

Clone this wiki locally