Blog post: Changing your Windows Terminal background image
Wrote a blog post about changing your Windows Terminal background using PowerShell. You can read it here: https://powershellisfun.com/2023/06/06/changing-your-windows-terminal-background-image/ The script that I made: #Parameter usage: # -All changes all configured profiles except the Default Profile # -DefaultProfile changes the Default Profile settings. Every new profile will inherit the wallpaper setting from it # -Profiles can be used for specifying one or multiple profiles separated by ','. Example Set-WindowsTerminalBackgroundImage "PowerShell 5" or Set-WindowsTerminalBackgroundImage "PowerShell 5", "Azure Cloud Shell" [CmdletBinding(DefaultParameterSetName = 'None')] param( [Parameter(Mandatory = $true, ParameterSetName = 'All')] [Switch]$All, [Parameter(Mandatory = $true, ParameterSetName = 'DefaultProfile')] [Switch]$DefaultProfile, [Parameter(Mandatory = $true, ParameterSetName = 'Profiles')] [String[]]$Profiles, [Parameter(Mandatory = $false, ParameterSetName = 'All')] [Parameter(Mandatory = $false, ParameterSetName = 'DefaultProfile')] [Parameter(Mandatory = $false, ParameterSetName = 'Profiles')] [String]$RandomBackgroundFolder, [Parameter(Mandatory = $false, ParameterSetName = 'All')] [Parameter(Mandatory = $false, ParameterSetName = 'DefaultProfile')] [Parameter(Mandatory = $false, ParameterSetName = 'Profiles')] [String]$BackgroundPath ) #Check if RandomWallpaperFolder and WallpaperPath were used at the same time. Exit if they were if ($RandomBackgroundFolder -and $BackgroundPath) { Write-Warning ("RandomBackgroundFolder and BackgroundPath parameters can't be used both, Set-WindowsTerminalBackgroundImage is exiting") break } #Check $BackgroundPath location if ($BackgroundPath) { if (-not (Get-ChildItem -Path $BackgroundPath -ErrorAction SilentlyContinue | where-object Extension -In '.jpg', '.jpeg', '.png', '.bmp', '.gif', '.tiff', '.ico')) { Write-Warning ("Specified Wallpaper {0} has no .jpg, .jpeg, .png, .bmp, .gif, .tiff, .ico extension, check spelling or permissions. Set-WindowsTerminalBackgroundImage is exiting..." -f $BackgroundPath) break } } #Check $RandomBackgroundFolder for files (≥ 1) and set $BackgroundPath to random wallpaper if ($RandomBackgroundFolder) { if (-not ((Get-ChildItem -Path $RandomBackgroundFolder -Include *.jpg, *.jpeg, *.png, *.bmp, *.gif, *.tiff, *.ico -Recurse -ErrorAction SilentlyContinue).count -ge 1 )) { Write-Warning ("No Wallpapers found in {0}. (Searched for *.jpg, *.jpeg, *.png, *.bmp, *.gif, *.tiff, *.ico files). Set-WindowsTerminalBackgroundImage is exiting..." -f $RandomBackgroundFolder) break } else { Write-Host ("{0} Wallpapers were found in {1}, continuing... " -f (Get-ChildItem -Path $RandomBackgroundFolder -Include *.jpg, *.jpeg, *.png, *.bmp, *.gif, *.tiff, *.ico -Recurse).count, $RandomBackgroundFolder) -ForegroundColor Green } } #Retrieve Settings.json location try { $json = Get-Content $env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\Settings.json -Raw -ErrorAction Stop | ConvertFrom-Json -ErrorAction Stop } catch { Write-Warning ("Windows Terminal Settings.json was not found. Is Windows Terminal installed? Check permissions if it is, Set-WindowsTerminalBackgroundImage is exiting...") break } #Loop through all specified Profiles in $profiles and change the wallpaper to the one specified in $BackgroundPath or random one from $RandomBackgroundFolder #Check if the profile exists and skip if not found if ($Profiles) { foreach ($Profile in $Profiles) { if ($profilesettings = $json.profiles.list | Where-Object name -eq $profile -ErrorAction Stop) { if ($RandomBackgroundFolder) { $BackgroundPath = (Get-ChildItem -Path $RandomBackgroundFolder -Include *.jpg, *.jpeg, *.png, *.bmp, *.gif, *.tiff, *.ico -Recurse | Get-Random).Fullname } $profilesettings | Add-Member -NotePropertyName 'backgroundImage' -NotePropertyValue $BackgroundPath -Force:$true Write-Host ("Changing Wallpaper for Profile {0} to {1}" -f $Profile, $BackgroundPath) -ForegroundColor Green } else { Write-Warning ("Specified Profile {0} was not found, Set-WindowsTerminalBackgroundImage is skipping profile..." -f $Profile) } } } #Loop through all Profiles in and change the wallpaper to the one specified in $BackgroundPath or the random one from $RandomBackgroundFolder if ($All) { foreach ($Profile in $json.profiles.list) { $profilesettings = $json.profiles.list | Where-Object name -eq $profile.name -ErrorAction Stop if ($RandomBackgroundFolder) { $BackgroundPath = (Get-ChildItem -Path $RandomBackgroundFolder -Include *.jpg, *.jpeg, *.png, *.bmp, *.gif, *.tiff, *.ico -Recurse | Get-Random).Fullname } $profilesettings | Add-Member -NotePropertyName 'backgroundImage' -NotePropertyValue $BackgroundPath -Force:$true Write-Host ("Changing Wallpaper for Profile {0} to {1}" -f $Profile.name, $BackgroundPath) -ForegroundColor Green } } #Change the wallpaper for the Default Profile to the one specified in $BackgroundPath or the random one from $RandomBackgroundFolder if ($DefaultProfile) { if ($RandomBackgroundFolder) { $BackgroundPath = (Get-ChildItem -Path $RandomBackgroundFolder -Include *.jpg, *.jpeg, *.png, *.bmp, *.gif, *.tiff, *.ico -Recurse | Get-Random).Fullname } $json.profiles.defaults | Add-Member -NotePropertyName 'backgroundImage' -NotePropertyValue $BackgroundPath -Force:$true Write-Host ("Changing Wallpaper for Default Profile to {0}" -f $BackgroundPath) -ForegroundColor Green } #Save modified Settings.json, overwriting the existing one try { $json | ConvertTo-Json -Depth 10 | Out-File $env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\Settings.json -Force -Encoding utf8 } catch { Write-Warning ("Error saving {0}, check permissions..." -f "$($env:LOCALAPPDATA)\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\Settings.json") }
