SysInfo
Measure=SysInfo
measures various information about your system.
Note: SysInfo was previously a plugin measure.
In many existing skins you might see the syntax:
[MeasureSysInfo] |
SysInfo still works with those forms, and changing existing skins to the new Measure=SysInfo
syntax is entirely optional. However, new skins created going forward should use the correct syntax for accuracy and clarity. SysInfo is a measure, and not a plugin.
[MeasureSysInfo] |
Options
- General measure options
- All general measure options are valid.
SysInfoType
-
Item of system information to retrieve. Some returned values are String for use in string measures or meters, and some are Number for use in any measure or meter.
General system values
COMPUTER_NAME
: [String] The computer's name as specified in the system settings.USER_NAME
: [String] The name of the current Windows user account.USER_SID
: [String] The security identifier associated with the current Windows user account.USER_LOGONTIME
: [Number] A timestamp number (number of seconds since January 1, 1601) reflecting the date and time the current user account logged onto Windows. Use with a Time measure to get a formatted string of the date/time, or subtract from the current time and use with an Uptime measure to get a formatted string of the elapsed time.LAST_SLEEP_TIME
: [Number] A timestamp number (number of seconds since January 1, 1601) reflecting the date and time Windows last entered a sleep state. Use with a Time measure to get a formatted string of the date/time, or subtract from the current time and use with an Uptime measure to get a formatted string of the elapsed time.LAST_WAKE_TIME
: [Number] A timestamp number (number of seconds since January 1, 1601) reflecting the date and time Windows was last returned from a sleep state. Use with a Time measure to get a formatted string of the date/time, or subtract from the current time and use with an Uptime measure to get a formatted string of the elapsed time.OS_PRODUCT_NAME
: [String] The version of Windows including the OS edition. E.g.Windows 10.0 Home
.OS_VERSION
: [String] The version of Windows. E.g.Windows 10.0
.OS_BITS
: [Number] Returns whether the version of Windows is32
or64
bit.PAGESIZE
: [Number] The size in bytes of the current contiguous page size allocated for system memory.IDLE_TIME
: [Number] The number of seconds since the last mouse or keyboard input to the operating system.
Network values
HOST_NAME
: [String] The computer's network host name.DOMAIN_NAME
: [String] The computer's network domain name.DOMAIN_WORKGROUP
: [String] The computer's network domain or workgroup name.DNS_SERVER
: [String] The computer's network primary DNS server IP address.ADAPTER_DESCRIPTION
: [String] The description (name) of the network adapter specified bySysInfoData
.ADAPTER_TYPE
: [String and Number] The type of network adapter specified bySysInfoData
.
The string value will be one ofEthernet
,Wireless
orOther
. The number value will be one of6
(Ethernet),71
(Wireless), or some other number in the range 0-280 (Other). The meaning of numeric codes other than 6 and 71 can be found at: docs.microsoft.com Adapter Info.ADAPTER_ALIAS
: [String] The network interface connected to by the network adapter specified bySysInfoData
. Examples areEthernet 1
orWiFi 3
.ADAPTER_GUID
: [String] The GUID of the network adapter specified bySysInfoData
.ADAPTER_STATE
: [String and Number] Gets the "media connected state" of the network adapter specified bySysInfoData
. This works for physical and non-physical adapters. The number value will return 1 for connected, and -1 for disconnected. The string value will return Connected or Disconnected. Any other state returns 0 and Unknown.ADAPTER_STATUS
: [String and Number] The operational status of the network adapter specified bySysInfoData
. This works for physical and non-physical adapters. The values returned are:
Number:-3
String:Not Present
Number:-2
String:Lower Layer Down
Number:-1
String:Down
Number:0
String:Unknown
Number:1
String:Up
Number:2
String:Dormant
Number:3
String:Testing
ADAPTER_TRANSMIT_SPEED
: [Number] The currently supported outbound speed of the network adapter specified bySysInfoData
. This is in bits per second, and if scaled, should be scaled by 1000 (AutoScale=2) to be consistent with Control Panel.ADAPTER_RECEIVE_SPEED
: [Number] The currently supported inbound speed of the network adapter specified bySysInfoData
. This is in bits per second, and if scaled, should be scaled by 1000 (AutoScale=2) to be consistent with Control Panel.MAC_ADDRESS
: [String] The physical MAC address of the network adapter specified bySysInfoData
.NET_MASK
: [String] The subnet mask of the network adapter specified bySysInfoData
.IP_ADDRESS
: [String] The LAN IP address of the network adapter specified bySysInfoData
.GATEWAY_ADDRESS
: [String] The gateway IP address of the network adapter specified bySysInfoData
.GATEWAY_ADDRESS_V4
: [String] The gateway IPv4 address of the network adapter specified bySysInfoData
.GATEWAY_ADDRESS_V6
: [String] The gateway IPv6 address of the network adapter specified bySysInfoData
.LAN_CONNECTIVITY
: [Number] Returns 1 if the network adapter specified bySysInfoData
for your computer is connected to a LAN, -1 if not.LAN_CONNECTIVITY_V4
: [Number] Returns 1 if the IPv4 IP address of the network adapter specified bySysInfoData
for your computer is connected to a LAN, -1 if not.LAN_CONNECTIVITY_V6
: [Number] Returns 1 if the IPv6 IP address of the network adapter specified bySysInfoData
for your computer is connected to a LAN, -1 if not.INTERNET_CONNECTIVITY
: [Number] Returns 1 if the network adapter specified bySysInfoData
for your computer is connected to the Internet, -1 if not.INTERNET_CONNECTIVITY_V4
: [Number] Returns 1 if the IPv4 IP address of the network adapter specified bySysInfoData
for your computer is connected to the Internet, -1 if not.INTERNET_CONNECTIVITY_V6
: [Number] Returns 1 if the IPv6 IP address of of the network adapter specified bySysInfoData
for your computer is connected to the Internet, -1 if not.
Monitor and screen values
NUM_MONITORS
: [Number] The number of display monitors currently active.SCREEN_SIZE
: [String] The resolution of the primary display monitor in the form "width x height".SCREEN_WIDTH
: [Number] The width, in pixels, of the monitor.SysInfoData
specifies which monitor if there are multiple.SCREEN_HEIGHT
: [Number] The height, in pixels, of the monitor specified bySysInfoData
.VIRTUAL_SCREEN_TOP
: [Number] Y-Coordinate of the upper left corner of the virtual screen. UseSysInfoData
to specify a monitor. These coordinates are relative to the primary monitor and can be negative.VIRTUAL_SCREEN_LEFT
: [Number] X-Coordinate of the upper left corner of the virtual screen. UseSysInfoData
to specify a monitor. These coordinates are relative to the primary monitor and can be negative.VIRTUAL_SCREEN_WIDTH
: [Number] Width of the virtual screen which encompasses all display monitors.VIRTUAL_SCREEN_HEIGHT
: [Number] Height of the virtual screen which encompasses all display monitors.WORK_AREA
: [String] The size of the client area of the primary display monitor in the form "width x height".WORK_AREA_TOP
: [Number] Y-Coordinate of the upper left corner of the client area. UseSysInfoData
to specify a monitor. These coordinates are relative to the primary monitor and can be negative.WORK_AREA_LEFT
: [Number] X-Coordinate of the upper left corner of the client area. UseSysInfoData
to specify a monitor. These coordinates are relative to the primary monitor and can be negative.WORK_AREA_WIDTH
: [Number] Width of the client area of the primary display monitor. UseSysInfoData
to specify a different monitor.WORK_AREA_HEIGHT
: [Number] Height of the client area of the primary display monitor. UseSysInfoData
to specify a different monitor.
Time Zone values
TIMEZONE_ISDST
[Number] A flag indicating the current state of Daylight Savings Time for the local computer.
Possible return values are:
1
: Daylight Savings Time is currently in effect
0
: Daylight Savings Time is currently not in effect
-1
: The local region does not use Daylight Savings Time, or the functionality is disabled in Windows.TIMEZONE_BIAS
[Number] The difference, in minutes, between standard local time and Coordinated Universal Time (UTC). This is the difference from the standard local time to UTC, orUTC = standard local time + time zone bias
.TIMEZONE_STANDARD_NAME
[String] The full name of the local computer's Time Zone when Daylight Savings Time is not in effect. For example, "Eastern Standard Time".TIMEZONE_STANDARD_BIAS
[Number] The difference in minutes between standard local time and the local time when Daylight Savings Time is not in effect. For most areas, this will always be zero. Adding this to the value of TIMEZONE_BIAS will produce the total actual difference in minutes between the local computer and UTC when Daylight Savings Time is not in effect, orUTC = standard local time + time zone bias + standard bias
.TIMEZONE_DAYLIGHT_NAME
[String] The full name of the local computer's Time Zone when Daylight Savings Time is in effect. For example, "Eastern Daylight Time".TIMEZONE_DAYLIGHT_BIAS
[Number] The difference in minutes between standard local time and the local time when Daylight Savings Time is in effect. For most areas, this will always be -60. Adding this to the value of TIMEZONE_BIAS will produce the total actual difference in minutes between the local computer and UTC when Daylight Savings Time is in effect, orUTC = standard local time + time zone bias + daylight bias
.
Note: Also see Daylight Savings Time TimeStamp options on Time measures.
SysInfoData
-
An additional selector option that can be used to define an instance for some SysInfoType values.
Network Interface Controller
For
SysInfoType
values related to network information, this will identify the network interface controller (NIC) to use.This can be defined in one of several ways:
- The string value
Best
, which will automatically detect the active interface. If not specified, this is the default. - The description (name) of the network interface controller. For example,
Qualcomm Wireless Network Adapter
. - The alias of the network interface. For example,
Ethernet
orWi-Fi 3
. - The index number of the network interface controller. This number can be found by starting Rainmeter with Debug turned on, but be aware that these numbers can change during normal usage of Windows.
Example:
SysInfoData=Best
Note: When the option is set to
Best
, the function will select a "wired" network connection in preference to a "wireless" one, if both are active.When the option is set to
Best
,DynamicVariables=1
must be set on the measure if you want it to automatically react to changes in the active interface. This should be done if for instance you have a laptop or other computer that you switch between wired and wireless connections, or if you change your connection using a VPN.Monitor number
For
SysInfoType
values related to monitor information, this will identify the monitor number to use.Note: The appropriate value to use can be found by opening the Windows Display Properties dialog. It is important to note that "1" is not always the primary display monitor.
- The string value
Example
[Rainmeter] |