wallpaper-box
macOS 开源壁纸客户端：支持静态、视频、网页与 AI 壁纸
下载 wallpaper-box
Apple 芯片与 Intel 通用安装包（.dmg），适合所有 Mac
其他可用下载（1）
- 下载
wallpaper-box-1.0.2-universal-mac.zip
universal · .zip · 434.1 MB
提示「无法验证开发者」怎么办？
首次打开若提示无法验证开发者，前往 系统设置 → 隐私与安全性，点击「仍要打开」即可。开源软件通常未购买 Apple 开发者签名，属正常现象。
点击「下载」将先到来源确认页，确认后开始下载。
关于 wallpaper-box
wallpaper-box 是一款面向 macOS 的开源桌面壁纸客户端，基于 Electron 构建。它支持静态、视频、网页和 AI 生成壁纸，可以直接粘贴 Bilibili 或 YouTube 链接下载视频并设为壁纸，也内置了随 CPU 使用率变速的 RunCat 风格托盘动画。壁纸资源来自 wallhaven.cc，可在线浏览、搜索、下载并设为壁纸。应用默认将壁纸保存在 ~/wallpaper-box 目录。项目使用 GPL-3.0 协议，代码开源。
下载或信息有问题？告诉我们
风险提示
该应用未经过 Apple Developer 签名，首次运行需要手动授权或去除隔离属性，存在一定的安全风险；在 macOS 上视频动态壁纸窗口可能无法完全覆盖整个屏幕（官方已知限制）；内置 yt-dlp 下载 YouTube/Bilibili 视频可能受平台条款和版权约束，请自行确认使用场景。
适合谁用
- 想用视频、网页或 AI 生成内容作为桌面壁纸的 macOS 用户
- 喜欢在托盘显示 CPU 动态动画（RunCat 风格）的用户
- 需要从 Bilibili / YouTube 直接下载视频设为壁纸的用户
- 愿意自备 API Key 配置 AI 壁纸生成的开源工具爱好者
- 不介意手动处理未签名应用的用户
不适合谁
- 仅使用 Windows 或 Linux 的用户（官方仅提供 macOS 安装包）
- 不愿运行终端命令或手动授权应用的用户
- 需要视频壁纸完美全屏覆盖的用户（macOS 上尚不能完全覆盖）
- 希望开箱即用、不想配置 AI 接口的用户
安装指南
本软件目前仅提供 macOS 通用（universal）安装包，同时兼容 Apple Silicon 和 Intel Mac。
- 推荐下载：
wallpaper-box-1.0.2-universal.dmg - 备用下载：
wallpaper-box-1.0.2-universal-mac.zip
安装步骤：
- 根据你的网络环境选择下载 DMG 或 ZIP 文件。两者内容一致，均为 universal 架构。
- 打开 DMG 文件，将
wallpaper-box.app拖入「应用程序」文件夹。 - 如果下载的是 ZIP，解压后同样将
wallpaper-box.app拖入「应用程序」文件夹。 - 双击启动。首次打开时，macOS 可能提示“无法打开，因为来自身份不明的开发者”。这是因为应用未经过 Apple Developer 签名。你可以：
- 在「应用程序」中右键点击
wallpaper-box.app，选择「打开」，然后在弹窗中再次确认； - 或前往「系统设置 → 隐私与安全性」，在“安全性”部分点击「仍要打开」。
- 若上述方法无效，可在终端中执行：
xattr -r -d com.apple.quarantine /Applications/wallpaper-box.app然后重新打开应用。
注意：README 中提供的 sudo spctl --master-disable 命令会全局关闭 Gatekeeper，降低系统安全性，不建议普通用户使用。
运行后，静态壁纸和 AI 生成的图片默认保存在 ~/wallpaper-box 目录；通过链接下载的视频保存在 ~/wallpaper-box/videos。
常见问题
wallpaper-box 是免费软件吗？
是。项目使用 GPL-3.0 开源协议，可以免费使用，也可以从 GitHub 获取源码。
支持 Windows 或 Linux 吗？
官方提供的安装包目前只有 macOS 版本，且默认构建为 universal，支持 Apple Silicon 和 Intel Mac。Windows 仅有界面预览，没有可下载的安装包。
如何更新到最新版本？
关注 GitHub 仓库的 Releases 页面，下载最新的 .dmg 或 .zip 文件，覆盖安装即可。应用本身不提供自动更新。
macOS 提示“无法打开”怎么办？
应用未签名，请参考安装指南第 4 步。可用右键打开或 xattr 命令去除隔离属性。
AI 壁纸功能需要什么配置？
需要自备 API Key。在“AI 壁纸”页面右上角设置中填写 API Base URL、模型和 Key，支持 OpenAI Images API 兼容接口（如 gpt-image-1）或智谱 glm-image。