WiFiStatus measure


Measure=WiFiStatus can be used to display various attributes of visible wireless networks in your area.

Note: WiFiStatus was previously a plugin measure.

In many existing skins you might see the syntax:

[MeasureParent]
Measure=Plugin
Plugin=WiFiStatus
or
Plugin=WiFiStatus.dll
or
Plugin=Plugins\WiFiStatus.dll

WiFiStatus still works with those forms, and changing existing skins to the new Measure=WiFiStatus syntax is entirely optional. However, new skins created going forward should use the correct syntax for accuracy and clarity. WiFiStatus is a measure, and not a plugin.

[MeasureParent]
Measure=WiFiStatus

Options

General measure options
All general measure options are valid.
WiFiInfoType

This defines what is measured. This option is required. Valid values are:

  • SSID: The broadcast name for your current connection. While actively trying to connect, you may see a 'connecting...' or 'authorizing...' next to the name.
  • Quality: Percentage value of the maximum dBm signal strength for your current connection.
  • TXRate: Theoretical maximum transmit speed in SI (1000) kilobits per second for your current connection.
  • RXRate: Theoretical maximum receive speed in SI (1000) kilobits per second for your current connection.
    Note: WiFi Band and Speed Information.
  • Encryption: The cipher algorithm being used for your current connection. Possible values are: NONE, WEP40, TKIP, AES, WEP104, WPA_GROUP, WEP, BIP, and GCMP. An unknown algorithm will return ???.
  • AUTH: The authentication algorithm being used for your current connection. Possible values are: Open, Shared, WPA-NONE, WPA-Enterprise, WPA-Personal, WPA2-Enterprise, WPA2-Personal, WPA3-Enterprise, and WPA3-Personal. An unknown algorithm will return ???.
  • PHY: The supported band for your connection (not your adapter). Possible values are 802.11a, 802.11ac, 802.11ad, 802.11ax, 802.11b, 802.11g, 802.11n, DSSS, FHSSS, and IR-Band. An unknown band will return ???.
  • List: Returns a list of all visible networks. The list is automatically separated by line-breaks, so each network appears on a separate line. It can also display the PHY, Encryption, AUTH, and Quality values next to the the network SSID, based on the value set in WiFiListStyle.
WiFiIntfID Default: 0
Only use this if you have more than 1 wireless interface adapter (which may include any bluetooth or infrared receivers). If you do not get any response from the measure with this value at 0, then try other values starting from 1, then 2 and so on.
WiFiListStyle Default: 0

This allows you to control what information appears along with the SSID names of all visible networks when WiFiInfoType=List. Valid values are:

  • 0: SSID
  • 1: SSID @PHY
  • 2: SSID (Encryption:AUTH)
  • 3: SSID @PHY (Encryption:AUTH)
  • 4: SSID [Quality]
  • 5: SSID @PHY [Quality]
  • 6: SSID (Encryption:AUTH) [Quality]
  • 7: SSID @PHY (Encryption:AUTH) [Quality]
WiFiListLimit Default: 5

Allows you to control the number of networks that are will be displayed when used with WiFiInfoType=List.

Note: The list will start with the interface with the strongest signal quality.

Example

[MeasureSSID]
Measure=WiFiStatus
WiFiInfoType=SSID

[MeasureNetworks]
Measure=WiFiStatus
WiFiInfoType=LIST
WiFiListStyle=3