Repository navigation
Releases
Waple v0.1.0-beta.2
Warning
This build does not launch. The DMG shipped without the bundled Wallpaper Engine shared
assets, so the app dies at startup with unable to find bundle named Waple_WapleRender.
The packaging script never copied the SwiftPM resource bundle into Waple.app, and the release
checks at the time only verified the DMG mounted and the signature was valid — the app itself was
never launched.
Fixed in v0.1.0-beta.5,
which is verified by downloading the published DMG and running it. Please use that instead.
(v0.1.0-beta.3 and v0.1.0-beta.4 had the same defect and were removed.)
The Waple.dmg download has been removed from this release (2026-08-16) so the broken
build can no longer be installed by mistake. The tag and these notes are kept as a record.
Waple v0.1.0-beta.2
Download Waple.dmg, open it, and drag Waple.app into /Applications.
Requires macOS 14 or later on Apple Silicon.
Verify
SHA-256 (Waple.dmg): 344e9dffd47385fb8be76b6ab8771b142a7742e19f9c2c20e8a17210a646e02c
First launch
This build is ad-hoc signed and not notarized, so Gatekeeper blocks the first launch.
Approve it once with either:
xattr -dr com.apple.quarantine /Applications/Waple.app
…or right-click the app and choose Open.
Supported wallpaper types and the scene feature matrix are in the
README. When updating a Homebrew cask, use the sha256 above
(see docs/RELEASING.md §3).
Waple 0.1.0 Beta 1 — First Public Beta
Warning
This build does not launch. The DMG shipped without the bundled Wallpaper Engine shared
assets, so the app dies at startup with unable to find bundle named Waple_WapleRender.
The packaging script never copied the SwiftPM resource bundle into Waple.app, and the release
checks at the time only verified the DMG mounted and the signature was valid — the app itself was
never launched.
Fixed in v0.1.0-beta.5,
which is verified by downloading the published DMG and running it. Please use that instead.
(v0.1.0-beta.3 and v0.1.0-beta.4 had the same defect and were removed.)
The Waple.dmg download has been removed from this release (2026-08-16) so the broken
build can no longer be installed by mistake. The tag and these notes are kept as a record.
Waple 0.1.0 Beta 1 — First Public Beta
Waple is a macOS menu-bar app that plays Wallpaper Engine workshop content natively. Instead of stretching a preview image, it renders the actual scene data inside each package with Metal.
Unofficial project — not affiliated with Valve, Steam, or Wallpaper Engine. It only plays files you already have locally; no Steam bypass, no downloads.
Highlights
- Native scene engine — translates WE's GLSL effect shaders to Metal Shading Language at runtime and executes them on the GPU. Particles, 3D meshes, puppets, audio reactivity, and text are all reproduced.
- Engine-parity pass against the WE 2.8.42 decompiled reference — lighting falloff, texture mip chains, MDL vertex layouts, particle semantics, and scene keys field-matched to the real engine.
- Video wallpapers — native mp4/mov/m4v playback; webm/mkv/avi auto-converted via ffmpeg.
- Web wallpapers — offline WKWebView with WE JavaScript API emulation (properties, audio spectrum, media hooks).
- Library app — grid browser, search & filters, per-monitor assignment, playlist rotation, screensaver integration, occlusion auto-pause.
Installation
- Open
Waple.dmgand drag Waple.app to Applications. - On first launch, right-click → Open. (The app is ad-hoc signed, so Gatekeeper asks once. Signed + notarized builds are planned for the stable release.)
Requirements: macOS 14 or later, Apple Silicon · Optional: ffmpeg for webm/mkv/avi conversion (brew install ffmpeg)
WE scenes reference shared base assets (shaders/common.h, etc.) that aren't bundled for copyright reasons — the first-launch onboarding lets you point Waple at them for the most complete rendering.
Known limitations (beta)
- Full WE runtime compatibility is the goal, not a guarantee — some scene features are still skipped or approximated.
- Text raster quality (edges on scaled/rotated text) and a few particle operators (boids/collision) are planned follow-ups.
- Something off? Please file an issue with the scene name / workshop ID.
Verification
SHA-256 (Waple.dmg): b2f8d726f2bfb5062ba08bc64ff569211872ac24b0354ce0d4b9d7bd10614699
Run shasum -a 256 Waple.dmg after downloading. For Homebrew cask updates, use the value above (see docs/RELEASING.md §3).
History: commit log · License: MIT (third-party notices in NOTICE)