Peter Hinchley

Learning in Public

✪ Using PowerShell to Automatically Change the Desktop Wallpaper Based on Screen Resolution

The default "Hero" wallpaper in Windows 10 is available under C:\Windows\Web\4K\Wallpaper\Windows in a variety of sizes matching common screen layouts. Wouldn't it be nice if you could automatically switch between these backgrounds when you change your screen resolution? Well, the script shown below will do exactly that.

The script, which is written using C# dressed up in the thinnest of PowerShell wrappers, listens for the DisplaySettingsChanged event (indicating a change in screen resolution). When the event is fired, the script iterates through all attached monitors, calculating the resolution, and applying a desktop wallpaper with a matching size (falling back to a default background if no match is found).

Unlike many solutions that rely on the SystemParametersInfo function to assign a single desktop background to all monitors, this solution uses the IDesktopWallpaper interface to assign a unique wallpaper to each monitor based on its specific resolution.

If you run this script using a scheduled task with an event trigger of "user logon", you can implement an automated solution for selecting the most appropriate desktop wallpaper whenever the logged on user changes the resolution (or orientation) of a monitor.

Note: The script will not work if users are prevented from changing the desktop wallpaper (i.e. if NoChangingWallPaper under SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\ActiveDesktop in either HKCU or HKLM is set to 1).

The script is configured to switch between the default Hero images included with Windows 10 (defaulting to C:\Windows\Web\Wallpaper\Windows\img0.jpg), but you can easily modify the code to support other resolutions if you have replaced or supplemented the default wallpaper with alternate images.

The script is also configured to display the configured wallpaper in Fill mode, but you can easily change this behaviour by using a different value from the DesktopWallpaperPosition enumeration when calling the SetPosition function.

Add-Type -TypeDefinition @"
using System;
using System.IO;
using System.Text;
using System.Drawing;
using System.Windows.Forms;
using System.Runtime.InteropServices;
using System.Linq;
using Microsoft.Win32;

namespace WinAPI {
  class DesktopWallpaper
    public struct Rect
      public int Left;
      public int Top;
      public int Right;
      public int Bottom;

    public enum DesktopSlideshowOptions
      ShuffleImages = 0x01

    public enum DesktopSlideshowState
      Enabled = 0x01,
      Slideshow = 0x02,
      DisabledByRemoteSession = 0x04

    public enum DesktopSlideshowDirection
      Forward = 0,
      Backward = 1

    public enum DesktopWallpaperPosition
      Center = 0,
      Tile = 1,
      Stretch = 2,
      Fit = 3,
      Fill = 4,
      Span = 5

    [ComImport, Guid("B92B56A9-8B55-4E14-9A89-0199BBB6F93B"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    public interface IDesktopWallpaper
      void SetWallpaper([MarshalAs(UnmanagedType.LPWStr)] string monitorID, [MarshalAs(UnmanagedType.LPWStr)] string wallpaper);

      [return: MarshalAs(UnmanagedType.LPWStr)]
      string GetWallpaper([MarshalAs(UnmanagedType.LPWStr)] string monitorID);

      [return: MarshalAs(UnmanagedType.LPWStr)]
      string GetMonitorDevicePathAt(uint monitorIndex);

      [return: MarshalAs(UnmanagedType.U4)]
      uint GetMonitorDevicePathCount();

      [return: MarshalAs(UnmanagedType.Struct)]
      Rect GetMonitorRECT([MarshalAs(UnmanagedType.LPWStr)] string monitorID);

      void SetBackgroundColor([MarshalAs(UnmanagedType.U4)] uint color);

      [return: MarshalAs(UnmanagedType.U4)]
      uint GetBackgroundColor();

      void SetPosition([MarshalAs(UnmanagedType.I4)] DesktopWallpaperPosition position);

      [return: MarshalAs(UnmanagedType.I4)]
      DesktopWallpaperPosition GetPosition();

      void SetSlideshow(IntPtr items);

      IntPtr GetSlideshow();

      void SetSlideshowOptions(DesktopSlideshowDirection options, uint slideshowTick);

      uint GetSlideshowOptions(out DesktopSlideshowDirection options, out uint slideshowTick);

      void AdvanceSlideshow([MarshalAs(UnmanagedType.LPWStr)] string monitorID, [MarshalAs(UnmanagedType.I4)] DesktopSlideshowDirection direction);

      DesktopSlideshowDirection GetStatus();

      bool Enable();

    public class WallpaperWrapper
      static readonly Guid CLSID_DesktopWallpaper = new Guid("{C2CF3110-460E-4fc1-B9D0-8A1C0C9CC4BD}");

      public static IDesktopWallpaper GetWallpaper()
        Type typeDesktopWallpaper = Type.GetTypeFromCLSID(CLSID_DesktopWallpaper);
        return (IDesktopWallpaper)Activator.CreateInstance(typeDesktopWallpaper);

  public class Wallpaper
    public static void Main()
        SystemEvents.DisplaySettingsChanged += SystemEvents_DisplaySettingsChanged;

    static void SystemEvents_DisplaySettingsChanged(object sender, EventArgs e)
      string path = "C:\\Windows\\Web\\4K\\Wallpaper\\Windows\\img0_{0}.jpg";

      string[] resolutions = {

      uint counter = 0;
      string wallpaper = "";

      foreach (Screen screen in Screen.AllScreens) {
        int width  = screen.Bounds.Width;
        int height = screen.Bounds.Height;

        string resolution = width + "x" + height;

        if (! resolutions.Contains(resolution)) {
          if (width > height) {
            resolution = "3840x2160";
          } else {
            resolution = "2160x3840";

        wallpaper = path.Replace("{0}", resolution);

        if (File.Exists(wallpaper)) {
          SetWallpaper(counter++, wallpaper);

    public static void SetWallpaper(uint id, string path)
      DesktopWallpaper.IDesktopWallpaper wallpaper = DesktopWallpaper.WallpaperWrapper.GetWallpaper();

      if (id <= wallpaper.GetMonitorDevicePathCount()) {
        string monitor = wallpaper.GetMonitorDevicePathAt(id);
        wallpaper.SetWallpaper(monitor, path);

"@ -ReferencedAssemblies 'System.Drawing.dll', System.Windows.Forms