Wallflow 0.1.31

Wallflow 0.1.31 improves wallpaper switching and pause/resume across desktop Spaces, preserves the rendered surface during transitions, and removes system-wallpaper snapshot updates.

Highlights

• Smoother wallpaper switching: reuse each display's desktop window when selecting a wallpaper, stop the previous renderer, and reject its pending frame-capture and resume callbacks. Consume a command-line project only once so later display reconciliation does not replace the selected wallpaper.
• Preserved Space-transition surfaces: attach wallpaper windows to their display's ordinary desktop Spaces while excluding fullscreen-app Spaces. Metal, Canvas, scene, and WebKit surfaces remain attached while paused instead of being replaced by screenshots.
• Less work during transitions: remove the system-desktop fallback publisher and its image encoding and wallpaper writes. Canvas pause and re-pin paths avoid extra drawing and snapshot readbacks.
• Consistent pause/resume: keep Canvas simulation and input pinned until the host commits the matching presented frame; stop retired renderers and discard stale asynchronous results.
• More reliable verification: add desktop lifecycle and desktop-size Canvas performance self-tests. Missing or invalid self-test path arguments now print usage and fail before normal app startup; ZIP verification requires --self-test. Update both English and Chinese verification instructions.

Download and install

Requires Apple Silicon (arm64) and macOS 13 or later.

1. Download Wallflow-0.1.31-macOS-arm64.dmg.
2. Open the disk image and drag Wallflow.app to Applications.
3. Launch Wallflow and use its menu-bar icon to manage wallpapers.

The app is ad-hoc signed and is not notarized. A SHA-256 checksum file is included.

Validation

Built and packaged from commit ee16d69efe6b6312abf7b7b5883155d9292764d5 in a separate checkout. The arm64 app's ad-hoc signature and the DMG integrity checks passed.

The packaged app passed core, desktop lifecycle, Canvas-Metal, desktop-performance, native video, and scene self-tests, plus all 33 CLI error cases. The desktop lifecycle test completed 50 retained-surface pause/resume cycles without snapshots. At 4112 × 2658, the Canvas test submitted 48 frames in two seconds, zero frames during a two-second pause, and 48 frames after resume, with zero snapshot readbacks. The scene test likewise produced zero updates while paused.

Known verification limitation: --web-self-test failed on this machine: the WebKit CSS animation time remained at zero after resume. The previous 0.1.27 app reproduced the same failure. Diagnostic probes reported document.visibilityState == "hidden" even though AppKit reported the test window visible; making the test window opaque, moving the animation into the viewport, and launching through macOS did not resolve the check. WebKit animation resume is therefore not verified by this release run. Diagnostic edits are not included in the release. Library screenshot, external-web, and external ZIP-import tests were not rerun.

Compatibility

Space membership uses dynamically loaded private SkyLight APIs. When unavailable or unsuccessful, Wallflow falls back to standard AppKit behavior; macOS may then display its static background during Space transitions. Multi-display behavior, canceled switching gestures, and the full range of supported macOS versions have not been verified for this release. Automated lifecycle tests do not replace those visual checks.

Performance self-tests measure process CPU time and render/timer activity, not whole-system power consumption. Wallpaper Engine compatibility remains partial.

中文摘要

• 切换壁纸时复用桌面窗口，停止旧渲染器并丢弃过期回调，避免旧画面覆盖新壁纸。
• 普通桌面 Space 切换保留真实渲染表面，移除系统壁纸截图同步，减少图片编码和回读。
• Canvas 暂停时锁定模拟与输入，恢复到对应帧并由宿主确认后再继续播放。
• 新增桌面生命周期和桌面尺寸性能自测，修复自测漏传路径时误启动应用的问题。
• 核心、桌面生命周期、Canvas、桌面性能、视频、场景及 33 个命令行错误用例通过；网页自测在当前环境仍失败，旧版 0.1.27 也复现同样现象，故本轮未验证 WebKit 动画恢复。
• Space 处理使用非公开 SkyLight 接口，接口不可用时回退；多显示器与各 macOS 版本仍需进一步实机验证。
• 仅支持 Apple Silicon / macOS 13+，安装包为临时签名、未经公证，附 SHA-256 校验文件。

Wallflow 0.1.27

Wallflow 0.1.27 fixes false pauses when opening ordinary windows from the Dock, reduces background scene work, improves petal rendering, and adds particle asset ZIP imports.

Highlights

• More accurate auto-pause: app activation and Dock clicks trigger visibility checks instead of immediately freezing the wallpaper. Dock transition surfaces and visibly transparent windows are excluded from application coverage. Each display keeps its own pause/resume state.
• Less background scene work: one 30 FPS particle clock replaces separate pointer and particle polling. Static parallax uses pointer events; pause stops scene timers and input while preserving particle positions and lifetime. Particle layers and tinted textures are reused.
• Improved petals: honor emission rate, instance count, authored size and color; correct lifetime-based fades and TEXS row/mirror transforms. Resume keeps existing particles instead of clearing the effect.
• Particle asset ZIP imports: import a particle folder or ZIP through either wallpaper import or the particle asset dialog. Assets are shared across scenes and do not appear as standalone wallpaper library entries. Installation reloads scene wallpapers while retaining video and web renderers.
• Web input fix: bubbling mouse and pointer events are delivered once rather than re-dispatched to their ancestors.
• New icon: a blue-violet folded ribbon, with checked-in artwork and reproducible macOS icon exports.

Download and install

Requires Apple Silicon (arm64) and macOS 13 or later.

1. Download Wallflow-0.1.27-macOS-arm64.dmg.
2. Open the disk image and drag Wallflow.app to Applications.
3. Launch Wallflow and use its menu-bar icon to manage wallpapers.

The app is ad-hoc signed and is not notarized.

Validation and compatibility

Built from the tagged commit in a separate checkout. Core, scene pause/resume, WebKit, native video and Canvas-Metal self-tests passed. Real particle and scene ZIPs were tested in isolated import directories.

For the tested scene, the running clock produced 60 updates in two seconds, zero updates during a two-second pause, and resumed afterward. This is a scheduler check, not a measured whole-system power reduction.

Compatible Canvas wallpapers continue to use the existing Metal renderer; this release does not claim a Canvas rendering-core speedup or full Metal coverage. Scene support remains partial, and Windows visual parity has not been established.

中文摘要

• 修复从 Dock 打开普通窗口或激活应用时误暂停，按实际桌面可见性处理。
• 减少场景空闲唤醒，暂停保留粒子状态，改善花瓣数量、尺寸、颜色与淡出。
• 支持导入粒子素材 ZIP，修复网页重复输入，更新蓝紫色丝带图标。
• 仅支持 Apple Silicon / macOS 13+，附 SHA-256 校验文件。

Wallflow 0.1.20

Wallflow 0.1.20

Apple Silicon-only release. Download the disk image and open Wallflow.app.

Highlights

• Independent wallpapers per display: choose all displays or a specific physical display from the wallpaper library; assignments persist across launches.
• Isolated Space transitions: switching Spaces on one monitor no longer freezes or cancels the pause session on another monitor.
• Stable desktop return: video, web, Canvas, scene, and Metal renderers keep a locked pause-session frame until playback is stably resumed, preventing stale-frame jumps and stretching flashes.
• Native scene particles: initial Wallpaper Engine particle parsing and Metal rendering, including optional import of Wallpaper Engine particle assets.
• Broader scene compatibility: resolves scene.pkg entries, string-encoded vectors, pass-based material textures, additional texture layouts, particles, and particle-driven scene properties.
• Wallpaper input fixes: desktop left-click and pointer events reach interactive wallpapers more reliably while system desktop chrome and right-click remain untouched.

Requirements

• Apple Silicon Mac
• macOS 13 or later

Install

1. Download Wallflow-0.1.20-macOS-arm64.dmg
2. Open the disk image
3. Open Wallflow.app (menu bar app; no Dock icon)

SHA-256:

85e23167188a50bedaec8d62cbf753f6e5c661494a4ca489a55c7881ebbb80d0

Wallflow 0.1.19

Wallflow 0.1.19

Apple Silicon-only release. Download the disk image and open Wallflow.app.

Highlights

• Checkpoint video resume: pause writes the media time; resume always seeks to that checkpoint, so returning from a long Space absence continues smoothly instead of jumping ahead.
• Per-display Space pause: one monitor’s Space/full-screen change does not pause the others.
• Desktop still on pause: the paused frame is set as that display’s system wallpaper.
• Right-click pass-through: desktop context menus stay with the system; only left-click is bridged into wallpapers.

Requirements

• Apple Silicon Mac
• macOS 13 or later

Install

1. Download Wallflow-0.1.19-macOS-arm64.dmg
2. Open the disk image
3. Open Wallflow.app (menu bar app — no Dock icon)

SHA-256:

dff4bdee8654ddfd85e57cc0d877190fc66d0d7dfd76271cc15219f988140e9d

Wallflow 0.1.18

Wallflow 0.1.18

Apple Silicon-only release. Download the disk image and open Wallflow.app.

Fixes

• Per-display Space pause: secondary displays now pause when their Space is covered or full-screen; one screen’s Space change no longer freezes the other.
• Smoother resume: live video no longer runs under the freeze frame, so returning to the desktop continues from the paused frame instead of jumping ahead.
• Desktop still on pause: each pause captures the current frame and sets it as that display’s system wallpaper (visible after quitting Wallflow).
• Right-click pass-through: desktop right-clicks are left to Finder; only left-click is bridged into wallpapers.

Requirements

• Apple Silicon Mac
• macOS 13 or later

Install

1. Download Wallflow-0.1.18-macOS-arm64.dmg
2. Open the disk image
3. Open Wallflow.app (menu bar app — no Dock icon)

SHA-256:

77b8d62ff395a3e21aa3c920d0a4b852f779c8e271fcc18cdb1e3ddc79d79573

Wallflow 0.1.17

Wallflow 0.1.17

Apple Silicon-only release.

Highlights

• Fixes the old desktop or white surface appearing briefly when returning from another Space.
• Keeps Wallflow above the system wallpaper and below desktop icons across Spaces and full-screen apps.
• Captures the last rendered frame before the desktop disappears, presents that frozen frame first, and reveals live animation only after Metal or WebKit is ready again.
• Adds real offscreen Metal snapshots and synchronizes a current static fallback for every display.
• Copies local files, project directories, and ZIP imports into ~/Library/Application Support/Wallflow/ImportedWallpapers instead of retaining temporary paths.
• Adds Locate Wallpaper... recovery for unavailable library entries left by older versions.
• Adds persistent per-wallpaper Auto, Fill, Fit, and Stretch display modes for video, web, and scene wallpapers.
• Improves Canvas-Metal mouse interaction, WebKit dominant-media sizing, native video presentation, and scene layout behavior.

Verified

• Packaged-app core self-test passes.
• Packaged-app WebKit pause/resume self-test passes.
• Packaged-app wallpaper-library UI self-test passes.
• The extracted release archive passes its self-test and code-signature verification.
• Release binary is arm64 and targets macOS 13 or later.

SHA-256:

8e61d944e9e9795336777cd501f0ff99ba50f0c851beb596dc974fff94db41c0

Download Wallflow-0.1.17-macOS-arm64.zip, extract it, and open Wallflow.app.

Wallflow 0.1.16

Wallflow 0.1.16

Apple Silicon-only release.

Highlights

• Adds a capability-based Canvas 2D-to-Metal renderer without modifying wallpaper source files.
• Runs compatible Wallpaper Engine web wallpapers through JavaScriptCore and Metal, with automatic WebKit fallback for unsupported APIs.
• Renders Canvas-Metal wallpapers at the display's full native Retina backing resolution.
• Keeps MP4/M4V/MOV playback on AVFoundation.
• Pauses animation, input, and Metal command submission when the desktop is fully hidden.
• Adds a low-frequency coverage watchdog for same-application window maximize and resize changes that do not emit Workspace notifications.
• Preserves the last rendered frame across full-screen Space transitions.

Verified

• Original Koi wallpaper source runs unchanged through Metal.
• Visible Koi playback CPU is approximately 3-5% on the tested Apple Silicon Mac.
• Hidden desktop CPU is 0.0%, and automated tests verify that no Metal command buffers are submitted while paused.
• All project, Canvas-Metal, WebKit, video, scene, localization, and wallpaper-library self-tests pass.

Download Wallflow-0.1.16-macOS-arm64.zip, extract it, and open Wallflow.app.