WallpaperMachine壁纸自定义指南:属性调节、命名预设与实时预览全解
WallpaperMachine壁纸自定义指南:属性调节、命名预设与实时预览全解
WallpaperMachine 是一款免费开源的 macOS 动态壁纸应用,让你在 Mac 上运行来自 Steam 创意工坊的 scene、视频和网页壁纸。本指南带你从零掌握它的三大自定义能力:属性调节、命名预设和实时预览——改一个滑杆,桌面上立刻看到效果,还能把调好的方案存成预设一键切换。
快速上手:打开壁纸属性面板
- 启动 WallpaperMachine,在 Library(库) 页面点击任意已安装壁纸的缩略图;
- 如果右侧没有展开面板,点击工具栏的 Wallpaper details 按钮;
- 右侧 Inspector 面板中,最下方的 Wallpaper properties 卡片就是属性调节区。
面板的分区从上到下依次是:通用设置(静音、音量、音频响应)、Displays(逐屏缩放模式、位置)、Collections、以及排在最后的 Wallpaper properties——长属性列表不会把常用分区挤到屏幕外。
属性调节:滑杆、颜色、开关与一键恢复
属性行采用「左标签、右控件」布局:滑块/数值、下拉菜单、颜色色块、开关按原作者的定义顺序排列,文本和文件选择器则独占整行。
| 操作 | 作用 |
|---|---|
| 直接拖动滑杆 / 点击颜色 | 修改属性值(松手后生效) |
| 悬停属性行出现的复位图标 | 把单个属性恢复为作者默认值 |
| Restore all defaults | 一次性把所有属性恢复默认 |
| Apply changes | 保存所有待生效的修改到壁纸 |
| Revert | 丢弃所有未保存的修改 |
几个值得注意的细节:
- 改动的行会显示 Modified 标记,复位后标记消失,方便你追踪改了什么;
- 音频、缩放模式、位置和帧率立即生效,其余属性需要 Apply changes 才落盘;
- 原作者可以为属性写 HTML 富文本标签、分组标题(
group),甚至用可见性规则隐藏控件——你看到的界面就是作者设计的样子。
相关实现可参考:PropertyRows.swift、PropertyLabelDocument.swift。
实时预览:不切屏就能看效果
在壁纸详情页点击 Preview wallpaper,会打开一个独立、可自由缩放的 Wallpaper Preview 窗口:
- ✅ 按目标显示器的比例渲染——竖屏、4:3、超宽屏都会以真实比例展示,而不是套一个 16:9 的框;
- ✅ 预览永不影响桌面:不会应用到显示器、不会改变选区、不会写入播放历史;
- ✅ 窗口自带 Play/Pause、静音和 Reload preview 按钮,新打开的预览默认静音;
- ✅ 场景预览上限 30 FPS,隐藏窗口或锁屏时自动挂起,省电不占帧。
编辑即时同步到预览
这是整个功能最爽的地方:窗口开着时,属性面板的每次修改都会实时反映到预览里,无需重载。
- 滑杆拖动过程中就在跟随(约每 100 ms 推一步),松手后的编辑则等 150 ms 停顿后读取一次草稿;
- 文本在提交时(回车或离开输入框)同步,避免每个按键都刷新;
- 选择新图片、文件或触发场景重建的修改,预览状态栏会提示 Reload preview to show the picture or files you chose.,点一下重载即可。
背后的调度逻辑由 PropertyPreviewScheduler.swift 负责「编辑停顿后合并更新」,窗口本身在 WallpaperPreviewWindow.swift。
进阶:让桌面直接跟随你的编辑
在 Settings → Desktop & Lock Screen → Desktop 中打开 Show property edits on the desktop as I make them 后,正在播放的 scene 壁纸会在你拖动滑杆时直接跟着变,连 Apply 都不用按。注意此时修改仍是「待保存」状态,锁屏和程序坞缩略图保持已保存的外观;Revert 会把桌面拉回已保存的样子。
命名预设:把调好的方案存成一键切换
属性调到满意后,别让它只活在内存里——Wallpaper properties → Save current… 可以把当前属性保存为一个命名预设(前提是待生效修改已 Apply 或 Revert)。
预设卡片(Presets)提供完整管理:
| 按钮 | 说明 |
|---|---|
| Save current… | 将当前属性另存为新预设(名称 1–120 字符) |
| Apply | 应用下拉框中选中的预设 |
| Rename… / Delete | 重命名或删除预设 |
| Export… / Import… | 导出/导入带版本号的 JSON 文档,可跨机器迁移 |
预设的几个实用特性:
- 📦 导出的便携文档最多内嵌 32 MB 的受管附件(如你为
scenetexture属性挑的图片),整个文档上限 48 MB——换台电脑也能完整还原你的方案; - 🔄 应用预设前会逐项校验类型、范围和选项,壁纸更新导致属性变更时宁可报错也不会半应用;
- 🎛 预设还能「切换模式并顺带设置该模式下的从属字段」,复杂联动也能一键搞定;
- 导入只是保存新预设,不会自动应用,应用与否由你决定。
预设数据结构定义在 WallpaperPresetStore.swift,界面在 PresetsCard.swift。
常见疑问(FAQ)
Q:改了属性但桌面上没变化? A:大部分属性需要点 Apply changes 才真正生效;或者打开上文提到的「桌面跟随编辑」开关,拖动过程即可见。
Q:预览窗口和桌面应用是同一份画面吗? A:不是。预览窗口是独立会话,关闭即释放渲染器,不会占用桌面播放。
Q:预设和「性能档位」是一回事吗? A:不是。性能档位属于全局画质设置,属性预设是每个壁纸各自的命名快照。
Q:哪些壁纸能调属性? A:视频壁纸本身没有作者属性,所以没有可调节项;scene 和网页壁纸的属性由创作者在项目中定义,数量随壁纸而异。
小结
WallpaperMachine 的自定义工作流可以概括为三步:调属性 → 看实时预览 → 存命名预设。配合按显示器比例还原的预览窗口和桌面跟随编辑开关,调参体验接近即所得;而预设的导出/导入则让整套方案可以备份和迁移。更多细节见官方功能文档:wallpaper-properties.md、control-panel.md。

