当前状态

本项目仍处于持续开发中。

社区交流

• 项目 QQ 交流群：867740762

安装

1. 从 Releases 下载

从 GitHub Releases 下载最新测试版。

如果电脑显示“Zest Wallpaper.app”已损坏，无法打开。请在终端执行：

xattr -dr com.apple.quarantine "/Applications/Zest Wallpaper.app"

然后重新打开应用。

2. 自行构建

前置依赖：

• Node.js
• Rust toolchain
• Xcode Command Line Tools

安装依赖：

npm install

启动前端开发服务器：

npm run dev

启动完整 Tauri 开发应用：

npm run tauri:dev -- --no-watch

构建前端：

npm run build

构建应用包：

npm run tauri:build

运行测试：

npm test
cargo test -j 1 --manifest-path src-tauri/Cargo.toml
cargo check -j 1 --manifest-path src-tauri/Cargo.toml

支持范围

能力	状态
场景壁纸	部分支持
视频壁纸	支持
网页壁纸	支持
音频输入	支持
全屏自动暂停	支持
多显示器	尚未测试
创意工坊壁纸下载	未支持

平台与技术栈

• 仅限 macOS 14.0+ 使用
• 当前打包产物仅支持 Apple Silicon (arm64)
• 目前暂不支持 Intel 芯片 Mac
• Tauri 2
• React + Vite
• Rust

特别鸣谢

感谢以下项目提供的公开工具与生态参考价值：

• repkg
• linux-wallpaperengine

许可证

Apache License 2.0。参见 LICENSE。

声明

Wallpaper Engine 是第三方产品。本项目是一个独立的 macOS 播放器，不隶属于、不受其官方认可、不代表其官方立场，也不与 Wallpaper Engine 或其专有资源一同分发。

还需要明确以下边界：

• 本仓库不分发第三方专有壁纸资源
• 导入的壁纸内容应由用户自行提供
• 可以通过本地挂载外部 assets 目录来提升 Scene 兼容性
• 即使没有外部 assets，应用本身也必须保持可运行
• 如果你使用本地外部 assets，请将它们保存在仓库之外

本仓库的目标是提供独立播放器实现，而不是作为任何第三方商业内容的再分发渠道。