Project

PowerBGInfo

PowerBGInfo is a PowerShell module that is used to generate background information for Windows machines. It's a replacement for BGInfo that doesn't require installation and is much more flexible.

Stars160
Forks18
Open issues6
PowerShell Gallery downloads501335
Releasev0.0.5
Language: C# Updated: 2026-04-11T10:19:04.0000000+00:00

Curated Examples

Position background information

Use PowerBGInfo layout options to control where generated information appears.

This pattern is useful when wallpaper text must avoid logos, taskbars, or other visual elements.

It comes from the source example at Examples/Run.BGInfo3.ps1.

When to use this pattern

  • You need consistent placement across machines.
  • The background image already has visual constraints.
  • You want an authoring script rather than a manual editor.

Example

Import-Module .\PowerBGInfo.psd1 -Force

New-BGInfo -MonitorIndex 0 {
    New-BGInfoValue -BuiltinValue HostName -Color Red -FontSize 20
    New-BGInfoValue -BuiltinValue OSName -Color White -Name 'Operating System'
    New-BGInfoValue -BuiltinValue OSVersion -Color White
    New-BGInfoValue -BuiltinValue OSLastBootUpTime -Color White
} -FilePath 'C:\Images\CompanyWallpaper.jpg' `
  -ConfigurationDirectory "$PSScriptRoot\Output" `
  -PositionX 75 `
  -PositionY 75 `
  -WallpaperFit Fit

What this demonstrates

  • using explicit X/Y placement
  • showing operating system values
  • keeping the output directory repeatable

Source