Repository navigation
v2026.11.0001 - Initial Release
Universal Windows Wallpaper Changer v2026.11.0001 - Initial Release
First public release. Sets a random, free 4K wallpaper on Windows - once, or on a schedule in the background with a tray icon. Works for the current user only. No administrator rights are needed.
Highlights
- One random 4K wallpaper from free sources that need no API key: FirstEverTech, Bing, Picsum, Wallhaven (or a random mix of them).
- FirstEverTech source: the author's own 4K photos (release tag
wallpapers), filterable by tags such as nature, wood, city. - Background mode with a tray icon and start at sign-in - changes the wallpaper every 1-1440 minutes.
- Multiple sources: free services, your own folders (used in place, never copied or deleted), your own image links or .txt lists, and optional API-key services (Flickr, Immich, Pexels, Pixabay, Unsplash).
- Security: SHA-256 self-hash verification against GitHub Releases, one-click update from the SFX package or PowerShell Gallery, with hash check of the new version.
- Dynamic credits: support links and messages are loaded from data/universal-windows-wallpaper-changer-credits.txt and data/universal-windows-wallpaper-changer-ads.txt on GitHub RAW, with an embedded fallback in the script when offline.
- API keys are stored encrypted with DPAPI for the current Windows user; environment variables override stored keys.
Sources
| Source | API key | Query | Notes |
|---|---|---|---|
| FirstEverTech | No | Yes (tags) | Author's own 4K photos, wizard default |
| Bing | No | No | Landscape only, max 3840 px |
| Picsum | No | No | Random photos |
| Wallhaven | Optional | Yes | SFW only, higher limits with a key |
| Photos | No | No | Windows Pictures folder, used in place |
| Folder | No | No | Any folder, used in place |
| URL | No | No | Image link or .txt list of links |
| Flickr | Yes | Yes | EXPERIMENTAL |
| Immich | Yes | No | EXPERIMENTAL, own server |
| Pexels | Yes | Yes | New keys currently paused |
| Pixabay | Yes | Yes | Free API: max 1280 px |
| Unsplash | Yes | Yes | 50 requests per hour |
If a service supports a query and you give none, a random one of Nature, Abstract, Minimalist, Anime or Cyberpunk is used. FirstEverTech with no query picks any photo.
Quick start
Interactive start screen (wizard or one random 4K wallpaper):
.\universal-windows-wallpaper-changer.ps1
One random 4K wallpaper from FirstEverTech, Bing, Picsum or Wallhaven:
.\universal-windows-wallpaper-changer.ps1 -Once
Change every 30 minutes in the background:
.\universal-windows-wallpaper-changer.ps1 -Source Wallhaven -Query "forest" -IntervalMinutes 30
Background changer status:
.\universal-windows-wallpaper-changer.ps1 -Background Status
Full option list:
.\universal-windows-wallpaper-changer.ps1 -help
Security and verification
- Self-hash verification: on every interactive start the script compares its own SHA-256 hash with the reference hash published in this release (universal-windows-wallpaper-changer-2026.11.0001-ps1.sha256).
- Auto-update: checks src/universal-windows-wallpaper-changer.ver on GitHub RAW; if a newer version exists, downloads the package (WindowsWallpaperChanger--Win10-Win11.exe) from the release, verifies its SHA-256, installs it silently, verifies the installed script and restarts. The previous copy is restored on any failure. If the package is unavailable, the .ps1 asset of the release is used.
- API keys: encrypted with DPAPI for the current Windows user, stored in HKCU:\Software\FirstEverTech\UniversalWindowsWallpaperChanger\Keys. Keys are never accepted on the command line and never written to logs.
- PowerShell Gallery: if installed with Install-Script, updates go through Update-Script instead of direct download.
Optional flags: -SkipVerify (skip self-hash), -NoUpdate (skip update check).
System requirements
| Component | Minimum | Recommended |
|---|---|---|
| Windows | 10 1809 (17763) | 11 22H2+ |
| .NET Framework | 4.7.2 | 4.8+ |
| PowerShell | 5.1 | 5.1+ |
| Administrator | Not required | Not required |
| Internet | Required for online sources | Required |
Windows 10 LTSB 2015/2016 may need manual updates for TLS 1.2.
Files in this release
| File | Purpose |
|---|---|
| WindowsWallpaperChanger-2026.11.0001-Win10-Win11.exe | SFX package: installs the script (also used by the updater) |
| WindowsWallpaperChanger-2026.11.0001-Win10-Win11.sha256 | SHA-256 of the package |
| universal-windows-wallpaper-changer.ps1 | Main script |
| universal-windows-wallpaper-changer-2026.11.0001-ps1.sha256 | SHA-256 reference hash for self-verification |
Data files (loaded from main branch, not from this release)
| File | Purpose |
|---|---|
| src/universal-windows-wallpaper-changer.ver | Latest version string for auto-update |
| data/universal-windows-wallpaper-changer-credits.txt | Credits screen content |
| data/universal-windows-wallpaper-changer-ads.txt | Promotional links (keys A-E) |
These are fetched with a cache-buster, so updates are visible immediately after commit to main.
Known limitations
- Bing images are copyrighted and meant for personal use.
- Flickr and Immich support is experimental and not verified against live accounts/servers.
- Pixabay free API delivers at most 1280 px regardless of -MinWidth.
- Unsplash allows 50 requests per hour; intervals under 5 minutes can hit the limit.
- Background mode runs for the current user only (per-user registry HKCU).
- FirstEverTech photos are the author's own work and are downloaded from the release tagged
wallpapers(GitHub download limits apply).
Links
- Repository: https://github.com/FirstEverTech/Universal-Windows-Wallpaper-Changer
- Issues: https://github.com/FirstEverTech/Universal-Windows-Wallpaper-Changer/issues
- License: MIT
- Author: Marcin Grygiel / FirstEver.tech
Full changelog: initial release.