Windows Background

See Github to download and for details: https://github.com/ITAutomator/IntuneApp/tree/main/Windows%20Background

Overview

Standardize a Windows desktop background image (and color) across endpoints.

Background


More information

See also: https://github.com/ITAutomator/IntuneApp/tree/main/Windows%20Background
See also: https://github.com/ITAutomator/IntuneApp

Setup Steps

Main menu


  1. Download from GitHub as ZIP and look for the Windows Background folder.
  2. Create a \IntuneApp\Wallpaper\wallpaper1.png
    See Common Display Resolutions below for size suggestions but QHD 2560 x 1440 is a good start
    These will end up in the common documents folder: C:\users\public\documents\Walllpaper
  3. Set the Background Color and WallpaperStyle in SetDesktop.csv
    Background Color=#040E4C for Dark Blue (Hex color code from www.color-hex.com)
    WallpaperStyle = Fill to fill the entire screen with the image, preserving the aspect ration (AR) and cropping image as needed
    Note: Fill obviates the need for Background Color; for smaller images, use Center
  4. Test it
    Double-click SetDesktop.cmd to test it
    If you are scriping the installation use SetDesktop.ps1 -mode auto to automatically install the wallpaper
  5. (Optional) For users of the IntuneApp app publishing system
    Change intune_settings.csv to adjust publication audience

Settings in SetDesktop.csv

Open SetDesktop.csv and adjust these values

Wallpaper

wallpaper=wallpaper1.png
The filename of the wallpaper (just name, no path)
If this is left blank (or invalid) you’ll just get the background color

Common Display Resolutions

If you want to fill the entire display background, use an image (.png preferred) of this size.

DisplayResolution (H x V)Aspect Ratio
4K3840 x 216016:9
QHD *2560 x 144016:9
FHD1920 x 106016:9

* Recommended

WallpaperStyle

WallpaperStyle=Fill

Recommended settings

Wallpaper that fills the screen: large .png file with QHD resolution using Fill WallpaperStyle
Wallpaper showing background color: small .png using Center WallpaperStyle and BackgroundColor matching image

WallpaperStyle values

StyleDescriptionRegValBackground Color may appear around edgesImage Crop may happenImage Scale may happenImage Aspect Ratio maintained
Fill*Expands image to cover the screen, leaving some to hang off screen10NYYY
FitShrinks image so that it can be entirely seen (letterbox)6Y (if AR of screen and image don’t match)NYY
Center*Centers the image on the screen0YYNY
StretchBreaks aspect ratio of image (stretches each dimension) to align image edges with screen edges.2NNYN
SpanPulls the image across multiple displays22NYYY

* Recommended

Background Color

Background Color=#040E4C (for Dark Blue)

Use the hex code for the color. www.color-hex.com
If you choose the background color of your image, you will have a centered image that blends with the background.

Some standard color examples

ColorHex
black#000000
blue1#000040
blue2#040E4C
green1#0C590C
green2#1A241B

Settings in intune_settings.csv (Optional) for users of the IntuneApp app publishing system

Open \IntuneApp\intune_settings.csv and adjust these values if you are using the IntuneApp app distribution system

To make this a mandatory app (push to all users)

  • set PublishToOrgGroup = TRUE

To make this mandatory for new users only, but not for existing users, use this IntuneApp technique:

  • Publish once with PublishToOrgGroup = FALSE and CreateExcludeGroup = TRUE
  • This creates an app-only exclude group (ending in Exclude).
  • Add all current users to the app-only exclude group.
  • Publish again with set PublishToOrgGroup to TRUE to pubish to any future users.

If you are replacing a previously pushed background, use this IntuneApp technique to overwrite previous installs:

  • Change AppUninstallVersion to match the last AppVersion
  • If you don’t adjust this, endpoints with prior versions will not get the new wallpaper

Technical Information

IntuneApp Publishing System

This app was packaged for compatibility with the IntuneApp Publishing System. It can also be installed:

  • automatically by other package delivdery systems using
    Powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -File IntuneUtils\intune_install.ps1 -quiet
  • manually by double-clicking intune_command.cmd

Information about the IntuneApp Publishing System

Leave a Reply

Your email address will not be published. Required fields are marked *