Skip to content

Releases

Waple v0.1.0-beta.2

Waple v0.1.0-beta.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 30 Jul 13:37

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

Choose a tag to compare

@github-actions github-actions released this 30 Jul 10:45

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

  1. Open Waple.dmg and drag Waple.app to Applications.
  2. 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)