"High-Performance HTML5 Live Desktop Engine"
Download Release • Source Code • Bundled Themes • Report Bug
Wallpaper for Windows is a system-integrated live wallpaper engine that enables the rendering of standard HTML5/JS/WebGL content directly on the desktop. By utilizing a hybrid C# and Rust architecture, it provides an efficient gateway for interactive and animated backgrounds with minimal resource consumption.
| Component | Implementation Details | Notes |
|---|---|---|
| Control Shell | .NET Framework 4.0 (WallpaperManager.exe) |
Win32 Handle & UI Management |
| Renderer Engine | Rust-based Chromium Embedded (wall-renderer.exe) |
High-concurrency WebGL support |
| Display Injection | Win32 SetParent / Progman hooks |
Direct Desktop Plane rendering |
| Optimization | Background Fullscreen Polling | GPU-suspend during high-load |
| Configuration | Local JSON Persistence | 100% Offline |
- 🎨 HTML5 Native Support: Render any local or remote
.htmlfile as your active desktop background. - 🖥️ Multi-Monitor Logic: Independent wallpaper assignment and scaling for complex workstation setups.
- ⚡ Low-Latency Rendering: Embedded Rust engine ensures smooth 60Hz+ animations for physics-based themes.
- 🔄 State Persistence: Automated restoration of wallpaper history and monitor mapping on system boot.
- 🕹️ Game Mode Protocol: Real-time monitoring of foreground windows to suspend rendering during fullscreen applications.
| Template | Visual Characteristics | Resource Load |
|---|---|---|
default.html |
Animated Gradient & Particle System | Low |
temporal-flux.html |
Cyberpunk HUD with 3D Object Rotation | Medium |
memento.html |
Minimalist Text Transformation | Minimal |
Build the management shell using the native Windows C# compiler:
# 1. Compile the Manager Shell
& "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe" /target:winexe /win32icon:assets/icon.ico /out:"WallpaperManager.exe" "src/WallpaperManager.cs"
# 2. Execute Primary Binary
.\WallpaperManager.exeImportant
Network Integrity: The core engine operates offline. External connections depend entirely on individual wallpaper payloads (e.g., CDN fonts or external API calls defined in your custom HTML).
Tip
Customization: To add a new wallpaper, simply drop your HTML directory into assets/wallpapers/. The manager will automatically detect and list the new entry in the selection panel.
Released under Proprietary (Structured Freedom) specifications. See md/LICENSE.md for full terms and usage permissions.