🇬🇧 English |
🇵🇱 Polski |
🇩🇪 Deutsch |
🇫🇷 Français |
🇪🇸 Español |
🇧🇷 Português |
🇳🇱 Nederlands
🇨🇳 中文 |
🇯🇵 日本語 |
🇰🇷 한국어 |
🇮🇹 Italiano |
🇹🇷 Türkçe |
🇸🇦 العربية |
🇮🇳 हिन्दी |
🇷🇺 Русский
Universal Windows Wallpaper Changer downloads a random, free high-resolution wallpaper (4K by default) from a free image service (or picks one from your own folder) and applies it as the Windows desktop wallpaper. Runs once, or keeps changing in the background with a tray icon.
This project was built through a pragmatic collaboration between human expertise and AI-assisted tooling.
Windows has no built-in way to rotate wallpapers from multiple free sources without third-party bloatware. This tool gives you a zero-config way to keep your desktop fresh — with no API keys required for the default sources and no administrator rights.
In addition to free wallpapers selected with a filter from various online services, my tool now also includes my own wallpapers. I’m pleased to announce the first series of 30 photos in 4K quality and PNG format, taken on the island of Santorini. You can also use the filter to search for photos by phrase (1-3 words), e.g. Sunset, Architecture, Ship. I will add more photos from other locations in the future.
For detailed documentation and guides, see:
→ How the image filter pipeline works (coming soon)
→ Deploying via MDM / silent mode (coming soon)
→ Security and verification (coming soon)
Universal Windows Wallpaper Changer is free and open-source — maintained by a single developer.
The provider integrations, background mode and image filtering pipeline are maintained in my free time.
If this tool saved you time or made your desktop a little nicer — consider supporting development. 🎯 Follow on Patreon for free — stay updated on new releases and development progress.
No sponsors yet — be the first and add your company ad!
A huge thank you to all our supporters – your contributions make a real difference.
Your name could be here too. Every bit helps cover development costs and ensures these tools continue to improve.
- Sqania, jadeanemail, westor7, J. A. Dean, Bartechr, tsantaliki, PegHorse
If this project helped you, please click the "Star" button at the top of this page on GitHub.
- Official threads on forums:
🔗 TechPowerUp, Guru3D, WinClub, ElevenForum, Win-Raid, and Station-Drivers.
Tip
I specialize in Windows deployment, driver automation, hardware compatibility, Microsoft technologies, infrastructure analysis, and custom IT tooling. If your organization faces automation, deployment, device management, or unsupported hardware environments, let's discuss how I can help.
🔗 Business Contact: firstever.tech/contact 🔗 LinkedIn Profile: linkedin.com/in/marcin-grygiel
- Table of Contents
- Release Highlights
2.1 Latest Version
2.2 Previous Release - Application Overview
- Key Features
4.1 Multiple Free Sources
4.2 Background Mode
4.3 Security & Verification
4.4 Customization
4.5 Setup Wizard & Profiles
4.6 API Key Management - System Requirements
5.1 System Requirements Table
5.2 Windows Version Support
5.3 Legacy System Notes - Quick Start
6.1 Method 1: Interactive Start Screen
6.2 Method 2: One Random Wallpaper
6.3 Method 3: Background Changer
6.4 Method 4: PowerShell Gallery
6.5 Command-Line Options - How It Works
7.1 Self-Verification & Update Check
7.2 Image Source Selection
7.3 Download & Filter Pipeline
7.4 Wallpaper Application
7.5 JPEG Import Quality (Windows 11)
7.6 Files & Locations - Security First Approach
8.1 Verified Security Layers - Usage Scenarios
9.1 Home Users
9.2 IT Professionals
9.3 System Builders - Download Options
10.1 Option 1: SFX Executable (Recommended)
10.2 Option 2: Direct PS1
10.3 Option 3: PowerShell Gallery
10.4 Option 4: Source Code - Project Structure
- Release Structure
12.1 Primary Files
12.2 Verification Files
12.3 Data Files - Frequently Asked Questions (FAQ)
- Image Source Comparison
- Performance Metrics
15.1 Typical Execution Time Breakdown
15.2 Disk Space Usage - Known Issues
- Ready to Use?
17.1 Quick Start Guide
17.2 Verification Steps (Optional)
17.3 Need Help? - Contributing
- License
- Acknowledgments
- Important Links
- Author & Contact
v2026.11.0002 → Release Notes
- Tray menu: "Current wallpaper" shows a readable title for FirstEverTech photos, built from the tags in the file name (e.g.
FirstEverTech - Nature Forest). - Random run info: when the source is
Random, the run summary shows which source was actually picked.
v2026.11.0001 → Release Notes
- 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, published in the
wallpapersrelease, filterable by tags (nature,wood,city, ...). - Background mode with 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
.txtlists, 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.
- Dynamic credits: support links loaded from
data/universal-windows-wallpaper-changer-credits.txton GitHub RAW, with an embedded fallback. - API keys stored encrypted with DPAPI for the current Windows user; environment variables override stored keys.
After an interactive run a credits screen follows: keys 1–5 (and A–E for current promotional links) open the support links, any other key exits. Support and ad links are loaded from GitHub RAW with an embedded fallback. It is not shown with -Quiet.
| Source | API key | Query | Notes |
|---|---|---|---|
| FirstEverTech | No | Yes (tags) | Author's own 4K photos (JPG), default source in the wizard |
| Bing | No | No | Landscape only, max 3840 px |
| Picsum | No | No | Random photos, server-side crop available |
| Wallhaven | Optional | Yes | SFW only, higher rate limits with a key |
| Photos | No | No | Windows Pictures folder, used in place |
| Folder | No | No | Any folder, used in place, never copied/deleted |
| 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, Cyberpunk is used. FirstEverTech is the exception: no query means any photo from the collection.
The photos are attached to the GitHub release tagged wallpapers, together with wallpapers.json (the list of photos with sizes and tags). File names follow FirstEverTech_<tag>_<tag>_<tag>_<NNN>.jpg (1-3 tags), e.g. FirstEverTech_nature_wood_forest_001.jpg. A query is a list of tags; every word must match a tag of the photo:
.\universal-windows-wallpaper-changer.ps1 -Source FirstEverTech -Query "nature forest" -Once
The photos are the author's own work (3840x2160, JPG, quality 100%). They are free to use through this tool and as your own wallpaper; redistribution and removing metadata or watermarks are not allowed. See the wallpapers release for the full terms. The list is cached locally and refreshed on use.
In the tray menu a FirstEverTech photo is shown by a title built from its tags: the first and the third tag (with fewer tags, all of them), each word capitalised — FirstEverTech_nature_wood_forest_001.jpg becomes Nature Forest.
For best quality with JPG wallpapers, set the Windows JPEG import quality to 100% (see 7.5).
- Hidden PowerShell process with tray icon (one instance at a time)
- Start at sign-in via
HKCU\Software\Microsoft\Windows\CurrentVersion\Run - Runs from a stable copy of the script in
%LOCALAPPDATA%\UniversalWindowsWallpaperChanger\, so moving or deleting the downloaded file does not break it - The first change happens within seconds, then every 1–1440 minutes; after a failed change it retries in at most 5 minutes (longer if the source is rate limited)
- Pause / Resume / Change now from the tray menu, or with
-Background Pause | Resume | Start | Stop | Status -Background Stopalso removes start at sign-in and the saved background settings- Daily update check in the tray: a balloon notification appears when a newer version exists
- The start screen has a Manage the background changer entry (status, change now, pause / resume, stop, start again, remove settings)
- State persisted in
%LOCALAPPDATA%\UniversalWindowsWallpaperChanger\state.json
Tray menu:
| Item | What it shows / does |
|---|---|
| Universal Windows Wallpaper Changer | Opens the project page |
Version x |
Opens the release notes of the running version |
| Current wallpaper | Source and title or author, e.g. FirstEverTech - Nature Forest | Photo: 12 (the number is the _N of the saved file name; not shown for files used in place) |
| Resolution / Size / Format | e.g. Resolution: 3840x2160 | Size: 6.7MB | Format: JPG (85%); JPG shows the Windows JPEG import quality (see 7.5). Shown only while the current wallpaper is the one set by the tool |
| Last change | Outcome and attempt (e.g. Successful (1/5)), then the next change time and interval, or Paused |
| Change now | Changes the wallpaper immediately (also resumes if paused) |
| Pause / Resume | Stops or continues the schedule |
| Last used wallpapers | Opens the wallpapers folder (with the number of stored images) |
| Open Wallpaper Setup Wizard | Opens the wizard in a new window |
| Startup with Windows (ON/OFF) | Toggles start at sign-in |
| Exit | Closes the tray process; start at sign-in stays as it was |
- SHA-256 self-hash verified against GitHub Releases on every interactive start
- Auto-update checks
src/universal-windows-wallpaper-changer.veron GitHub RAW; the new version is installed from the SFX package (or PowerShell Gallery) and verified by SHA-256 - DPAPI-encrypted API keys (never shown, never logged, never accepted on command line)
- No admin rights required — everything runs in HKCU
- Minimum width, minimum pixels, minimum file size filters
- Orientation: landscape, portrait, squarish
- Output format (JPG/PNG) and quality for services that convert (currently Unsplash; other services deliver files as they are)
-Keep <n>(default 20,0= keep all) or-KeepCurrentOnlyfor stored downloads — only the tool's own<service>_img_…files in-Dirare ever deleted, never the current wallpaper and never files used in place-MaxAttempts(1–20, default 5) and-Dir(where downloads are stored)- API keys overridable via environment variables
📸 SCREENSHOT PLACEHOLDER 2:
Insert here:assets/tray-menu.png— tray icon context menu showing "Current wallpaper", "Pause", "Change now".
Action: Skel w tej sekcji, wstaw obrazek po zrobieniu screenshota.
-Wizard(or the first entry of the start screen) asks, step by step: source → folder / link / server address (when the source needs it) → search phrase or tags → minimum width → minimum pixels → minimum file size → quality and format (Unsplash only) → orientation → how many images to keep → maximum attempts → run mode (once, or repeat every n minutes)- Steps that do not apply to the chosen source are skipped. A source that needs a key opens the key screen first
- Wizard defaults: FirstEverTech, 3840 px, minimum file size 2.5M (the command-line default is off), landscape, keep 20, 5 attempts, once
- The summary screen offers: [1] Run now, [2] Print the command only (ready to paste; keys are never part of it), [3] Save as the default profile, [4] Save as a custom profile, [5] Start again
- Profiles are JSON files in
%APPDATA%\UniversalWindowsWallpaperChanger\profiles\. Run the default one with-Profile, a named one with-Profile <name>(letters, digits,_and-, up to 40 characters). The start screen lists saved profiles - Settings are merged in this order: built-in defaults < profile < command line
- At any wizard prompt
Sreturns to the start screen andXexits (with the credits screen)
-Keysshows which keys are set (never the keys themselves);-SetKey <service>asks for a key with hidden input;-RemoveKey <service|All>removes the stored key and the user environment variable- The same is available interactively: start screen → Manage API keys, and the key screen the wizard opens for services that need one
- Services: Flickr, Immich, Pexels, Pixabay, Unsplash (key required), Wallhaven (key optional)
- Environment variables, which override stored keys:
FLICKR_API_KEY,IMMICH_API_KEY,PEXELS_API_KEY,PIXABAY_API_KEY,UNSPLASH_ACCESS_KEY,WALLHAVEN_API_KEY - Stored keys are DPAPI-encrypted for the current Windows user in
HKCU\Software\FirstEverTech\UniversalWindowsWallpaperChanger\Keys. The Immich server address is stored there too (-ImmichUrl) - A system-wide environment variable cannot be removed by the tool; it tells you where to remove it
| Component | Minimum | Recommended | Notes |
|---|---|---|---|
| Windows Version | 10 1809 (17763) | 11 22H2+ | 1809 requires .NET 4.7.2+ |
| .NET Framework | 4.7.2 | 4.8+ | Required for TLS 1.2 support |
| PowerShell | 5.1 | 5.1+ | Windows PowerShell 5.1 included |
| Administrator | Not required | Not required | HKCU only |
| Internet | Required for online sources | Required | For hash verification and updates |
| RAM | 2 GB | 4 GB+ | For image processing |
| Disk Space | 100 MB | 500 MB+ | Depends on -Keep setting |
| Version | Build | Status | Notes |
|---|---|---|---|
| Windows 11 | All builds | ✅ Full | Optimized support |
| Windows 10 | 22H2+ | ✅ Full | Recommended |
| Windows 10 | 21H2 | ✅ Full | Stable |
| Windows 10 | 21H1 (19043) | ✅ Full | Legacy |
| Windows 10 | 20H2 (19042) | ✅ Full | Legacy |
| Windows 10 | 2004 (19041) | ✅ Full | Legacy |
| Windows 10 | 1909 (18363) | ✅ Full | Legacy |
| Windows 10 | 1903 (18362) | ✅ Full | Legacy |
| Windows 10 | 1809 (17763) | ✅ Limited | Requires .NET 4.7.2+ for TLS 1.2 support |
| Windows 10 | LTSB 2016 (1607) | Manual updates required for TLS 1.2 | |
| Windows 10 | LTSB 2015 (1507) | Manual updates required for TLS 1.2 |
- Windows 10 1809 (17763) and newer: Full TLS 1.2 support out-of-the-box
- Windows 10 LTSB 2015/2016: May require manual installation of:
- .NET Framework 4.8
- KB4474419 (SHA-2 update)
- The tool automatically:
- Detects Windows version limitations
- Warns about potential connectivity issues
- Provides fallback options for offline operation
- Local sources (
Photos,Folder) work even without internet connectivity
.\universal-windows-wallpaper-changer.ps1
Opens the start screen with these entries (optional ones appear only when they apply, and numbers shift accordingly):
- Wallpaper Changer Wizard
- Set one random 4K wallpaper now
- Run your saved profile (default or custom; you pick one when several exist)
- Manage the background changer (when configured; shows running / stopped)
- Manage API keys
Press X to exit (credits screen).
.\universal-windows-wallpaper-changer.ps1 -Once
Sets one random 4K wallpaper from FirstEverTech, Bing, Picsum, or Wallhaven. The run summary shows which source was picked; if it has no suitable image, the next one is used.
An interactive one-time change replaces a configured background changer: it is stopped and removed from start at sign-in. -Quiet -Once leaves it alone.
.\universal-windows-wallpaper-changer.ps1 -Source Wallhaven -Query "forest" -IntervalMinutes 30
Changes the wallpaper every 30 minutes in the background with a tray icon.
Check status:
.\universal-windows-wallpaper-changer.ps1 -Background Status
Pause / Resume / Stop:
.\universal-windows-wallpaper-changer.ps1 -Background Pause
.\universal-windows-wallpaper-changer.ps1 -Background Resume
.\universal-windows-wallpaper-changer.ps1 -Background Stop
Install from PowerShell Gallery:
Install-Script -Name universal-windows-wallpaper-changer
Update:
Update-Script -Name universal-windows-wallpaper-changer
Run:
universal-windows-wallpaper-changer
📸 SCREENSHOT PLACEHOLDER 3:
Insert here:assets/start-screen.png— start screen with options [1] Wizard, [2] One random 4K wallpaper, etc.
Action: Skel w tej sekcji, wstaw obrazek po zrobieniu screenshota.
| Option | Description |
|---|---|
-help, -h, -? |
Display help and exit |
-version, -v |
Display version and exit |
-wizard |
Step-by-step setup wizard |
-source <name> |
Image source (Random, FirstEverTech, Bing, Picsum, Wallhaven, Photos, Folder, Flickr, Immich, Pexels, Pixabay, Unsplash, URL) |
-query <text> |
Search phrase, e.g. "nature winter" |
-folder <path> |
Folder for -Source Folder |
-url <link|file> |
Image link, or .txt list |
-minwidth <px> |
Minimum width. Default: 3840 |
-minpixels <n> |
Minimum width×height. Default: 0 (off) |
-minsize <size> |
Minimum file size, e.g. 500K, 1M. Default: 0 (off) |
-quality <1-100> |
JPEG quality for services that convert (Unsplash). Default: 95 |
-format <jpg|png> |
Output format for services that convert (Unsplash). Default: jpg |
-orientation <o> |
landscape / portrait / squarish |
-maxattempts <n> |
Images to try before failing (1-20). Default: 5 |
-dir <path> |
Where downloaded wallpapers are stored. Default: Pictures\Universal Windows Wallpapers |
-keep <n> |
Keep last n downloaded files. Default: 20 (0 = all) |
-keepcurrentonly |
Keep only current wallpaper |
-once |
Change once and exit |
-intervalminutes <n> |
Change every n min (1-1440) in background |
-profile [name] |
Run a saved profile (default name: default) |
-fresh |
Discard stored queue |
-immichurl <url> |
Immich server address |
-background <cmd> |
Status / Start / Stop / Pause / Resume |
-keys |
Show which keys are set |
-setkey <service> |
Enter a key (hidden input) |
-removekey <svc> |
Remove API key |
-jpegimportquality <Max|Default> |
Set Windows JPEG import quality and exit |
-noprompt |
Do not ask about the JPEG import quality |
-quiet, -q |
No screens, no prompts, no credits; also skips self-hash verification and the update check |
-noupdate |
Skip update check |
-skipverify, -s |
Skip self-hash verification |
-debug, -d |
Print diagnostic messages |
- Integrity Verification — Validates script SHA-256 against GitHub Release
- Update Detection — Compares current version with
src/universal-windows-wallpaper-changer.ver - Update from the SFX package — the new
WindowsWallpaperChanger-<version>-Win10-Win11.exeis downloaded from the release, its SHA-256 is checked, it is run silently and the installed script is verified again; the previous copy is restored if anything fails. If the package is unavailable, the.ps1asset of the release is used instead (also hash-checked) - PSGallery Path — If installed via
Install-Script, updates go throughUpdate-Script
Randompicks FirstEverTech, Bing, Picsum, and Wallhaven in random order and falls back to the next one when a source has no suitable image- Local sources (
Photos,Folder) scan files in place (jpg, jpeg, png, bmp, subfolders included) — never copy or delete.Photosskips the tool's own download folder. They try at least 30 images before giving up URLaccepts a single link or a.txtlist (local file or remote link): up to 2000 unique links, onlyhttp(s)://lines are used, links must point to the image file itself. Dropboxdl=0links are rewritten todl=1. Downloads are sent with aRefererand a browser-like user agent; if a site blocks the download (bot check), the tool says so — download the file in a browser and use-Source Folder
- Metadata pre-filter (width, height, orientation) before download
- Download to temp, then verify real dimensions via System.Drawing
- File type detected from magic bytes (not extension)
- Accepted files renamed to
<provider>_img_<date>_<N>.<ext> - Minimum file size is checked on the downloaded file (FirstEverTech also from the photo list, before download)
- Queue: images fetched but not yet used are kept per source, query, minimum width and orientation in
%LOCALAPPDATA%\UniversalWindowsWallpaperChanger\queueand used first next time (not forPhotos,Folder,Immich,URL).-Freshdiscards the queue - Rate limits: after HTTP 429 (and 403 for Unsplash) a source is paused — Unsplash and Pexels 55 min, Flickr 30 min, Pixabay and Wallhaven 2 min, others 5 min. The pause survives restarts; in background mode the next change waits for it
- Unsplash: the image is requested at your minimum width in the chosen format and quality, and every used photo is reported to Unsplash as its API guidelines require
SystemParametersInfowithSPI_SETDESKWALLPAPERWallpaperStyle = 10(Fill),TileWallpaper = 0- Attribution logged to
%LOCALAPPDATA%\UniversalWindowsWallpaperChanger\attribution.log— one tab-separated line per image: time, source, id, author, page link, author link, file name - Old files cleaned up according to
-Keep/-KeepCurrentOnly: only files named<service>_img_…in-Dirare counted (newest by creation time kept); the current wallpaper and local sources are never touched
When a wallpaper is set, Windows stores its own copy in %APPDATA%\Microsoft\Windows\Themes\TranscodedWallpaper. How much quality is kept depends on the source format and on the registry value HKCU\Control Panel\Desktop\JPEGImportQuality.
Measured on Windows 11, build 29704.100 (4K source images, one wallpaper change per test; other builds were not tested):
| Test | Source | JPEGImportQuality |
Windows copy | Size of Windows copy |
|---|---|---|---|---|
| 1 | PNG, 15.0 MB | not set | PNG | 15.33 MB |
| 2 | PNG, 15.0 MB | 100 | PNG | 15.33 MB |
| 3 | JPG, 6.74 MB | not set | PNG | 2.14 MB |
| 4 | JPG, 6.74 MB | 100 | PNG | 7.18 MB |
What the numbers show:
- PNG is not changed by Windows, with or without the setting (15.0 MB → 15.33 MB in tests 1 and 2).
- JPG without the setting is reduced from 6.74 MB to 2.14 MB (about -68%). The resolution of the Windows copy is the same as the source in all four tests, so the reduction comes from lossy recompression, not from scaling.
- JPG with the setting at 100 gives 7.18 MB (about +6%), so the recompression loss is avoided.
- The Windows copy is always a PNG, never a JPG, in all four tests.
Not measured: the quality value Windows uses when the setting is not present. The tool's pre-check assumes 85% in that case; this is an assumption, not a measurement.
What this means for the FirstEverTech photos: they are published as JPG (quality 100%) to save space and transfer. To keep their full quality on your desktop, set the value to 100:
.\universal-windows-wallpaper-changer.ps1 -JpegImportQuality Max
Restore the Windows default with -JpegImportQuality Default. The change is per-user (HKCU), needs no administrator rights, and takes effect after you sign out and in (or restart) and set the wallpaper again. Interactive runs show this as a pre-check after the startup checks, every time until the value is 100; -NoPrompt hides the question. It is also skipped with -Quiet, -Format png or redirected input.
| Location | Content |
|---|---|
%LOCALAPPDATA%\UniversalWindowsWallpaperChanger\ |
wallpaper.log (trimmed at 512 KB), attribution.log, state.json, background.json, command.txt, queue\, ratelimit_<source>.txt, firstevertech-wallpapers.json (cached photo list), the installed script copy used by background mode |
%APPDATA%\UniversalWindowsWallpaperChanger\profiles\ |
Saved profiles (<name>.json) |
%USERPROFILE%\Pictures\Universal Windows Wallpapers\ |
Downloaded wallpapers (default -Dir) |
HKCU\Software\FirstEverTech\UniversalWindowsWallpaperChanger |
DPAPI-encrypted API keys (Keys), Immich server address |
HKCU\Software\Microsoft\Windows\CurrentVersion\Run |
Start at sign-in (UniversalWindowsWallpaperChanger) |
HKCU\Control Panel\Desktop |
WallPaper, WallpaperStyle, TileWallpaper; JPEGImportQuality only if you set it |
Data from earlier folders (...\FirstEverTech\UniversalWindowsWallpaperChanger) is migrated automatically on start.
1. Self-Integrity → Script Hash Verification against GitHub Releases
2. API Key Safety → DPAPI encryption (current Windows user), never logged
3. Command Line → Keys never accepted on the command line
4. Log Safety → Secrets masked with Hide-Secret
5. Update Safety → SHA-256 check of the update; previous copy restored on mismatch
6. PSGallery → Verified by PowerShellGet (self-check skipped)
Self-hash verification and the update check run in interactive mode only. -Quiet and the background tray process skip them.
The FirstEver.tech certificate is self-signed. The PowerShell script (universal-windows-wallpaper-changer.ps1) is the authoritative source of the tool. Its SHA-256 hash is published on GitHub and verified automatically on every interactive run. The SFX executable is a convenience wrapper — it installs the same PS1, whose hash is verified on every interactive run.
Once the SFX is released: The SFX package may show a small number of detections — known false positives from SFX+PowerShell combinations. The PS1 script itself scores clean. Always verify the hashes published in the Release.
📸 SCREENSHOT PLACEHOLDER 4:
Insert here:assets/virustotal-ps1.png— VirusTotal scan of the PS1 showing 0 detections.
Action: Skel w tej sekcji, wstaw obrazek po zrobieniu screenshota.
- Fresh wallpaper daily without third-party apps
- No API keys for default sources
- One-click operation via wizard
- Silent deployment via
-quiet— no screens, prompts or credits; exit code 0 on success, 1 on failure; details inwallpaper.log. Self-hash verification and the update check are skipped in this mode - Silent background setup —
-quiet -IntervalMinutes 60 -Source Binginstalls the background changer and start at sign-in without any UI - Per-user — no admin rights, runs in HKCU
- Profile-based — save settings with
-wizard(default or custom profile), copy the JSON from%APPDATA%\UniversalWindowsWallpaperChanger\profiles\, run with-Profile [name] - Keys for unattended setups —
-SetKeyasks interactively; use the environment variables from 4.6 instead
- Pre-configured profiles for customer machines
- Folder source — use curated wallpapers without downloading
- Background mode — set once, runs at sign-in
- File:
WindowsWallpaperChanger-<version>-Win10-Win11.exe - Features: One-click install and start, installs the script to a fixed per-user folder, also used by the built-in updater
- Security: Self-verifying SHA-256 hash check on every interactive run
- For: Most users, easiest method
-
Features: Full control, modifiable code, transparency
-
Security: Self-verifying SHA-256 hash check on every interactive run
-
For: Advanced users, administrators, customization
powershell -ExecutionPolicy Bypass -File .\universal-windows-wallpaper-changer.ps1
- Method:
Install-Script universal-windows-wallpaper-changer- PowerShell command - Features: Versioned distribution via PSGallery, one-line install/update (
Update-Script) - Security: Self-verifying SHA-256 hash check on every interactive run
- For: Advanced users, administrators
- Method:
git clonethe repository - Features: Latest development version, full customization
- For: Developers, contributors
Key Files and Directories:
src/ - Main scripts directory
- universal-windows-wallpaper-changer.ps1 - Main PowerShell script
- universal-windows-wallpaper-changer.ver - Main Version file
data/ - Data files
- universal-windows-wallpaper-changer-credits.txt - Dynamic credits screen displayed at the end of the script (loaded from GitHub at runtime)
- universal-windows-wallpaper-changer-ads.txt - Promotional links (keys A–E)
assets/ - Screenshots and branding
- Universal-Windows-Wallpaper-Changer.png - Project banner
- stars-graph.svg - Star history chart (auto-generated)
- 1-security.png - Security screen (1 of 4)
- 2-source.png - Source selection screen (2 of 4)
- 3-filter.png - Filter screen (3 of 4)
- 4-apply.png - Apply wallpaper screen (4 of 4)
ISSUE_TEMPLATE/ - Issue templates
- bug_report.md - Bug report template
- config.yml - Issue templates configuration file
/ - Root directory files
- CHANGELOG.md - Project changelog
- CONTRIBUTING.md - Contribution guidelines
- KNOWN_ISSUES.md - Known issues and workarounds
- LICENSE - MIT License
- PULL_REQUEST_TEMPLATE.md - Pull request template
- README.md - Main project documentation
- SECURITY.md - Security policy
Each version (v202x.xx.xxxx) includes:
WindowsWallpaperChanger-202x.xx.xxxx-Win10-Win11.exe- Main executable (SFX package, also used for updates)universal-windows-wallpaper-changer.ps1- PowerShell script (inside the SFX and attached separately for direct use)
WindowsWallpaperChanger-202x.xx.xxxx-Win10-Win11.sha256- EXE hashuniversal-windows-wallpaper-changer-202x.xx.xxxx-ps1.sha256- PS1 script hash (used by self-check)
src/universal-windows-wallpaper-changer.ver- Latest version string for auto-updatedata/universal-windows-wallpaper-changer-credits.txt- Credits screen contentdata/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.
Photo release (separate): the release tagged wallpapers is not a version release. It holds the FirstEverTech photos and wallpapers.json and must not be marked as Latest.
Yes. The tool:
- Verifies its own SHA-256 hash against GitHub Releases
- Never requires administrator rights
- Stores API keys encrypted with DPAPI
- Never writes keys to logs or accepts them on the command line
No, for the default sources: FirstEverTech, Bing, Picsum, Wallhaven work without a key. Wallhaven has higher rate limits with a free key.
By default: %USERPROFILE%\Pictures\Universal Windows Wallpapers\.
Change with -Dir <path>.
Yes. Bing images are copyrighted and meant for personal use. The tool does not claim ownership or redistribute images. For commercial use, stick to Picsum, your own folders, or sources with explicit licenses.
The tool tries up to -MaxAttempts images (default 5). If all fail, it reports the reasons. For Random, it falls back through the other free sources (FirstEverTech, Bing, Picsum, Wallhaven).
The tool compares $ScriptVersion with src/universal-windows-wallpaper-changer.ver on GitHub RAW. If a newer version exists, it downloads the SFX package of that release, verifies its SHA-256, installs it and restarts (PowerShell Gallery installs use Update-Script).
Before running interactively, the tool calculates its own SHA-256 hash and compares it with the reference hash published in the GitHub Release. This ensures the script hasn't been modified or corrupted.
The FirstEver.tech certificate is self-signed. The PS1 script is the authoritative source, verified by SHA-256 on every interactive run. The SFX is a convenience wrapper.
Once released: Known false positives from SFX + PowerShell execution. The PS1 itself scores clean. See Section 8.3.
%LOCALAPPDATA%\UniversalWindowsWallpaperChanger\wallpaper.log
Yes, but wallpaper changing is per-user. On Server Core (no desktop), it has no visible effect.
Windows recompresses JPG wallpapers with loss unless JPEGImportQuality is set to 100; PNG wallpapers are left as they are. In our test a 6.74 MB JPG became a 2.14 MB copy without the setting and a 7.18 MB copy with it. Fix: -JpegImportQuality Max, then sign out and in. Details: 7.5.
-Background Stop (or start screen → Manage the background changer → Stop) ends the process and removes start at sign-in and the saved settings. The tray menu Exit only closes the tray process; start at sign-in stays as it was. To pause without stopping, use Pause or -Background Pause.
Yes, when run interactively: -Once (or the "Set one random 4K wallpaper now" entry) stops the background changer and removes it from start at sign-in, so it does not overwrite your wallpaper. -Quiet -Once does not.
Yes: -Source Photos (your Pictures folder), -Source Folder -Folder <path> (subfolders included) or -Source URL -URL <link or .txt list>. Files in folders are used in place and never copied or deleted.
Yes. The wizard saves a default profile (-Profile) or a named one (-Profile <name>), see 4.5. Command-line options override profile values.
| Feature | FirstEverTech | Bing | Picsum | Wallhaven | Photos/Folder | API-key services |
|---|---|---|---|---|---|---|
| API key | No | No | No | Optional | No | Yes |
| Query | Tags | No | No | Yes | No | Yes |
| 4K native | Yes (3840x2160 JPG) | Yes (UHD) | Yes (server crop) | Yes (filter) | Depends | Varies |
| Orientation filter | Yes (list data) | Landscape only | Yes (server) | Yes | Local scan | Yes |
| Used in place | No | No | No | No | Yes | No |
| Rate limit | GitHub | None | None | Higher with key | None | Varies |
| Experimental | No | No | No | No | No | Flickr, Immich |
| Phase | Time | Description |
|---|---|---|
| Compatibility Pre-Check | 5–10 seconds | OS build, .NET Framework, TLS 1.2 availability, GitHub connectivity verification |
| Verification & Update Check | 5–10 seconds | Self-integrity hash verification and updater version check |
| Image Fetch & Download | 2–15 seconds | Depends on source and image size |
| Filter & Verify | 1–3 seconds | System.Drawing dimension and orientation check |
| Wallpaper Apply | < 1 second | SystemParametersInfo call |
Note: Times above are measured on typical SSD-equipped systems with a standard broadband connection. On slower HDD systems or limited internet connections, individual phases (especially image download) may take significantly longer.
| Stage | Estimated Usage | Notes |
|---|---|---|
| Script | ~200 KB | Single PS1 file |
| Log file | < 512 KB | Auto-trimmed at 512 KB |
| Downloaded wallpapers | 2–10 MB each | Depends on source resolution |
| State & queue files | < 1 MB | JSON and CliXML |
| Persistent disk usage | Depends on -Keep |
20 images ≈ 40–200 MB |
Important notes:
- The current wallpaper is never deleted, even if
-Keepis exceeded. - With
-Keep 0, nothing is deleted automatically. - With
-KeepCurrentOnly, only the current wallpaper is kept.
For current limitations and workarounds, please see: KNOWN_ISSUES.md
Summary of known limitations:
- Bing images are copyrighted and meant for personal use
- Flickr and Immich support is experimental — 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)
- JPG wallpapers are recompressed with loss by Windows unless
JPEGImportQualityis 100 (-JpegImportQuality Max); PNG is not affected, see 7.5 - Windows 10 LTSB 2015/2016 may need manual TLS 1.2 updates
- Download latest release from Releases page
- Verify SHA-256 hashes (optional but recommended)
- Run the tool — no administrator rights required
- Follow prompts — the wizard handles everything automatically
- Enjoy your new wallpaper
- Check file hashes match published SHA256 files
- Review the Security First Approach section
We welcome contributions! Please feel free to submit pull requests, report bugs, or suggest new features.
Areas for Contribution:
- Additional free image source integrations
- Translation improvements
- Documentation enhancements
- Testing on various Windows versions
Please open an Issue before submitting a PR.
This project is licensed under the MIT License - see the LICENSE file for details.
- Bing, Picsum, Wallhaven for free image APIs; FirstEverTech photos by the author
- Flickr, Immich, Pexels, Pixabay, Unsplash for optional provider APIs
- AI audits
- Open source community for continuous improvement
- Beta testers for real-world validation
- Releases - Download latest version
- Issue Tracker - Report problems
- PowerShell Gallery - Install via PSGallery
- Security Policy - Security policy
- Known Issues - Known issues and workarounds
- 🌐 Website: www.firstever.tech
- 💼 LinkedIn: Marcin Grygiel
- 🔧 GitHub: FirstEverTech
- 📧 Contact: Contact Form
Note: This tool is provided as-is for convenience purposes. Always respect the license of every image you keep. Bing images are copyrighted and meant for personal use.





