cynegeirus / bginfo-custom-scripts

This repository provides a set of custom VBScript files designed to be used with BGInfo, a Sysinternals tool that displays system information on the Windows desktop. These scripts retrieve detailed system and network information that BGInfo doesn't provide by default.

Custom BGInfo Scripts

This repository provides a set of custom VBScript files designed to be used with BGInfo, a Sysinternals tool that displays system information on the Windows desktop. These scripts retrieve detailed system and network information that BGInfo doesn't provide by default.

Purpose

Each script collects specific data from the local system using WMI (Windows Management Instrumentation) and outputs it in plain text, which BGInfo can read and display on the desktop.

Available Scripts

Script Name	What It Shows
GetCpu.vbs	CPU brand (e.g., Intel, AMD)
GetCpuType.vbs	Cleaned-up CPU model name (e.g., i7-9700K)
GetDisk.vbs	System drive letter and size (e.g., C:\ 512 GB)
GetDnsAddress.vbs	DNS server IP addresses (IPv4 only)
GetFullName.vbs	Full name of the currently logged-in user
GetGatewayAddress.vbs	Default gateway IP (IPv4 only)
GetIpAddress.vbs	Local IPv4 address of the active network adapter
GetMacAdress.vbs	MAC address of the first physical adapter
GetRam.vbs	Total installed RAM in GB
GetSubnetAddress.vbs	Subnet mask of the active network adapter (IPv4 only)

How to Use with BGInfo

1. Download BGInfo
   Get it from the official site:
   https://learn.microsoft.com/en-us/sysinternals/downloads/bginfo

2. Copy the Scripts
   Place the .vbs files in a directory that BGInfo can access (e.g., C:\BGInfoScripts).

3. Configure Custom Fields in BGInfo

   • Open BGInfo.exe
   • Click on Custom > New
   • Choose VB Script File
   • Select one of the script files (e.g., GetIpAddress.vbs)
   • BGInfo will now show the script’s output as a variable (e.g., %GetIpAddress%)

4. Design Your Layout
   Add the custom fields into your BGInfo layout and format the desktop output as needed.

5. Save the Configuration
   Save your .bgi file and optionally set up BGInfo to run at login using Task Scheduler or a logon script.

Example Output on Desktop

CPU Brand     : Intel
CPU Model     : i7-9700K
RAM           : 16 GB
Disk          : C:\ 512 GB
IP Address    : 192.168.1.100
Gateway       : 192.168.1.1
DNS Servers   : 8.8.8.8, 8.8.4.4
MAC Address   : 00-1A-2B-3C-4D-5E
User Fullname : John Doe

Notes

• Scripts only return IPv4 addresses to reduce clutter.
• Full name defaults to PERSONELİMİZ if not set.
• You can edit or expand scripts to suit your specific environment or requirements.
• All output is plain text – fully compatible with BGInfo’s input system.

License

This project is licensed under the MIT License. See the license file for details.

Issues, Feature Requests or Support

Please use the Issue > New Issue button to submit issues, feature requests or support issues directly to me. You can also send an e-mail to [e-mail].