universal-windows-wallpaper-changer

Downloads a random free high-resolution wallpaper from a free image
service (or picks one from own folder) and applies it as the Windows
desktop wallpaper. Runs once, or keeps changing the wallpaper in the
background with a tray icon (every 1-1440 minutes). Works for the
current user only. No administrator rights are needed.

Usage: .\universal-windows-wallpaper-changer.ps1 [options]
Run without options to open the start screen.

SOURCES (-Source)
 Random      Bing, FirstEverTech, Picsum or Wallhaven (default)
 FirstEverTech  Author's own 4K photos (no key, tags)
 Bing        Bing image archive (no key)
 Picsum      Random photos (no key)
 Wallhaven   Wallpaper search, SFW only (no key, query)
 Photos      Windows Pictures folder (local)
 Folder      Folder given with -Folder (local)
 Flickr      API key needed (Pro), query. EXPERIMENTAL
 Immich      Own server, API key + URL. EXPERIMENTAL
 Pexels      API key needed, query
 Pixabay     API key needed, max 1280px, query
 Unsplash    API key needed, 50 req/hour, query
 URL         Image link or .txt list (-URL)

If a service supports a query and none is given, a random one of
Nature, Abstract, Minimalist, Anime or Cyberpunk is used.

OPTIONS
 -help, -h, -?      Show help and exit.
 -version, -v       Show version and exit.
 -wizard            Step-by-step setup wizard.
 -source <name>     Image source. Default: Random.
 -query <text>      Search phrase, e.g. "nature winter".
 -folder <path>     Folder for -Source Folder.
 -url <link|file>   Image link or .txt list.
 -minwidth <px>     Min width. Default: 3840 (4K).
 -minpixels <n>     Min width x height. Default: 0 (off).
 -minsize <size>    Min file size (500K, 1M). Default: 0.
 -quality <1-100>   JPEG quality (services that convert).
 -format <jpg|png>  Output format.
 -orientation <o>   landscape | portrait | squarish.
 -maxattempts <n>   Tries before failing (1-20). Default: 5.
 -dir <path>        Where wallpapers are stored.
 -keep <n>          Keep last n files (default 20, 0 = all).
 -keepcurrentonly   Keep only the current wallpaper.
 -once              Change once and exit.
 -intervalminutes n Change every n min (1-1440) in background.
 -profile [name]    Run a saved profile (default: default).
 -fresh             Discard the stored image queue.
 -immichurl <url>   Immich server address.

BACKGROUND
 -background <cmd>  Status | Start | Stop | Pause | Resume
                    Stop also removes start at sign-in and settings.

API KEYS (stored encrypted per Windows user; env vars override)
 -keys              Show which keys are set.
 -setkey <service>  Enter a key (hidden).
 -removekey <svc>   Remove key(s) and the user env variable.
                    ALL | FLICKR | IMMICH | PEXELS | PIXABAY |
                    UNSPLASH | WALLHAVEN

OTHER
 -jpegimportquality <Max|Default>  Windows JPEG import quality.
 -noprompt          Skip the JPEG quality prompt.
 -quiet, -q         No screens, prompts or credits.
 -noupdate          Skip the update check.
 -skipverify, -s    Skip the self-hash check.
 -debug, -d         Print diagnostics.
 -installupdate     Internal (used by the EXE package).

Files: %LOCALAPPDATA%\UniversalWindowsWallpaperChanger
      (log, state, queue, installed copy for background mode)
      %APPDATA%\UniversalWindowsWallpaperChanger\profiles