WEngine-Plus is an all-in-one upgrade suite for Wallpaper Engine. It replaces the stock interface script with an extended frontend (scripts.js) connected to a blazingly fast background helper daemon (wengine-helper.exe) written in Rust.
Discover, download, and manage Steam Workshop wallpapers directly inside Wallpaper Engine with zero reliance on the desktop Steam client, advanced multi-state filters, instant offline metadata caching, and integrated decompiler.
flowchart LR
subgraph UI ["Wallpaper Engine UI (scripts.js)"]
Bridge["WengineHelper Bridge"]
WorkshopUI["Workshop Browser & Pagination"]
FilterUI["Advanced Filters & 3-State Chips"]
MetaUI["Installed Details & Offline Meta"]
AuthUI["Steam QR & Cookie Auth"]
end
subgraph Backend ["WEngine Helper Daemon (wengine-helper.exe)"]
AxumRouter["Axum HTTP Server (:43196)"]
SteamClient["Steam SSR Parser & Scraper"]
MetaStore["Local metadata.json"]
Engine["Downloader & Unpacker"]
end
Bridge <-->|REST JSON| AxumRouter
WorkshopUI --> Bridge
FilterUI --> Bridge
MetaUI --> Bridge
AuthUI --> Bridge
AxumRouter --> SteamClient
AxumRouter --> MetaStore
AxumRouter --> Engine
- Steam Workshop inside Wallpaper Engine without running the Steam client
- Multi-threaded downloading & extraction in one click
- Offline metadata storage
- Automatic one-click installer
Specifically:
Workshop Browser
- Steam Workshop Integration: Full in-app workshop browser with search, sorting, and tag filters.
- Fast SSR Parser & Query Caching: Server-side Steam HTML parsing and query caching for instant response times.
Download & Extraction
- Multi-Threaded Downloader: Parallel asset downloads with live progress toasts and transfer speed tracking.
- Unpacker: Built-in decompiler for
.pkgprojects.
Steam Authentication & Account Management
- Web Session: Quick login via QR code scan, cookie, password, or system account (default).
- Accounts to Load: Switch between saved accounts or use the built-in public pool.
Built-in Patcher & Safety Backup
- One-Click Patcher: Running
wengine-helper.exeautomatically locatesscripts.js, creates a backup (scripts.js.bak), and installs the patched script. - Silent Background Execution: Wallpaper Engine automatically runs the helper daemon with
--daemonon startup without user intervention.
For a complete, line-by-line technical audit of all changes between the original Wallpaper Engine script and the enhanced scripts.js, see:
DIFF.md — Comprehensive Modification Diff
- Windows 10/11 (x64)
- Wallpaper Engine (installed)
- .NET Runtime 8/9/10 (auto-downloaded if missing)
- Download the latest
wengine-helper.exefrom Releases. - Run
wengine-helper.exe:- It automatically locates your Wallpaper Engine directory (via running processes, Steam registry, and standard paths).
- It copies itself to
ui\dist\scripts\wengine-helper.exe, creates a safety backup (scripts.js.bak), applies the patch, and cleans up the downloaded file from your original location. - Press Enter to close the window.
- Launch Wallpaper Engine normally.
Note
Wallpaper Engine automatically launches wengine-helper.exe in the background with the --daemon flag upon startup. You do not need to start it manually.
| Flag | Action |
|---|---|
wengine-helper.exe |
Interactive Patcher (Default): Inspects target, creates backup, applies patch, prompts for keypress. |
wengine-helper.exe -y |
Silent Patcher: Automatically applies patch and exits without confirmation prompt. |
wengine-helper.exe --daemon |
Daemon Mode: Starts background Axum REST server on port 43196. |
Development Setup
- Rust (v1.75+)
- Wallpaper Engine
- .NET Runtime/SDK 8/9/10
# Clone the repository
git clone https://github.com/psyattack/WEngine-Plus.git
cd WEngine-Plus
# Build release executable
cargo build --releaseThe compiled release binary is output to target/release/wengine-helper.exe.
|
|
View structure
WEngine-Plus/
├── Cargo.toml # Rust manifest & dependencies
├── Cargo.lock # Locked dependency tree
├── LICENSE # MIT License
├── DIFF.md # Exhaustive technical diff report
├── README.md # English documentation
├── README.ru.md # Russian documentation
├── scripts.js # Patched Wallpaper Engine frontend script
│
└── src/ # Backend Rust source code
├── main.rs # Daemon entry point, CLI routing & Axum server
├── setup.rs # Automated one-click installer & script manager
├── auth.rs # Auth module declarations
├── services.rs # Services module declarations
├── steam.rs # Steam module declarations
│
├── auth/ # Steam authentication subsystem
│ ├── accounts.rs # Account pool & QR code login manager
│ └── auth.rs # Session validation & token storage
│
├── services/ # Application services
│ ├── dotnet.rs # Portable .NET Runtime supervisor & installer
│ ├── download.rs # Multi-threaded download manager
│ ├── extract.rs # Archive extractor (.pkg, .bin, .zip, .rar)
│ ├── lifecycle.rs # Process supervisor & watchdog
│ ├── metadata.rs # Local metadata storage (metadata.json)
│ ├── plugins.rs # Plugin update & dependency manager
│ └── settings.rs # Daemon configuration manager
│
└── steam/ # Steam Workshop scraping & API
├── client.rs # HTTP client configuration
├── parser.rs # Steam Workshop HTML scraper
├── types.rs # Workshop item & query data models
└── url_builder.rs # Query string & filter constructor
All operational files are saved directly in the scripts directory:
C:\Program Files\Wallpaper Engine\ui\dist\scripts\
| File | Description |
|---|---|
scripts.js |
Enhanced Wallpaper Engine frontend script |
scripts.js.bak |
Untouched backup of the original script |
metadata.json |
Local metadata database of installed wallpapers |
wengine-helper.exe |
Background daemon & script patcher binary |
steam_session.json |
Saved Steam Account Session |
download_accounts.json |
Saved accounts for download |
plugins/ |
Auto-downloaded plugins (DepotDownloaderMod, RePKG) |
dotnet/ |
Portable .NET Runtime 9.0.17 (if needed) |
Contributions, bug reports, and suggestions are welcome! Feel free to open an Issue or submit a Pull Request.
This project is licensed under the MIT License.
- Download Tool: DepotDownloaderMod
- Package Extractor: RePKG
This application is not affiliated with or endorsed by Valve Corporation or Wallpaper Engine. Steam and Wallpaper Engine are trademarks of their respective owners.
For issues, questions, or feature requests, please open an issue on GitHub.