WebViewScreenSaver 技术文档

1. 安装指南

使用 Homebrew 安装

如果你已经安装了 Homebrew，可以使用以下命令安装 WebViewScreenSaver：

brew install --cask webviewscreensaver --no-quarantine

直接下载安装

你可以从项目的 releases 页面下载最新的安装包。下载后解压并双击安装。

从源码安装

如果你有 Xcode 开发环境，可以通过以下命令从源码安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/liquidx/webviewscreensaver/master/install-from-source.sh)"

注意事项

• 安装包是 adhoc 签名 的（自 v2.2.1 版本起，之前未签名）。
• 使用 --no-quarantine 参数可以禁用 macOS 的 Gatekeeper，避免安装时出现安全提示。
• 如果未使用 --no-quarantine，首次打开时会收到多个安全提示。点击 OK 后，进入 隐私与安全 设置，找到被阻止的 "WebViewScreenSaver.saver"，点击 打开。
• 如果通过直接下载安装，可以使用以下命令移除 quarantine 属性：

  xattr -d com.apple.quarantine WebViewScreenSaver.saver
  

2. 项目的使用说明

配置

1. 打开 系统偏好设置 > 桌面与屏幕保护程序 > 屏幕保护程序。
2. 在屏幕保护程序列表的末尾找到 WebViewScreenSaver。
3. 在地址栏中输入你希望屏幕保护程序循环显示的网页地址，并设置每个网页的停留时间。

提示

• 要编辑选中的行，可以点击一次或按 Enter 或 Tab。
• 如果输入负值（如 -1），屏幕保护程序将停留在该网页上，不再切换。
• 你可以参考 examples.json 中的示例网站。
• 支持本地文件路径，例如 file:///Users/myUser/mySreensaver/index.html。
• 注意：在 macOS Catalina 或更高版本中，路径不能位于需要额外权限的个人文件夹中（如 下载、文档 或 桌面）。

IT 配置

如果你需要通过脚本进行配置更改，WebViewScreenSaver 使用 macOS 的 defaults 系统。你可以通过以下命令查询和更新配置：

/usr/libexec/PlistBuddy -c 'Print' ~/Library/Containers/com.apple.ScreenSaver.Engine.legacyScreenSaver/Data/Library/Preferences/ByHost/WebViewScreenSaver.*.plist

3. 项目 API 使用文档

WebViewScreenSaver 没有提供具体的 API 文档，但其配置主要通过 macOS 的 defaults 系统进行管理。你可以使用 PlistBuddy 或 plutil 等工具编辑相关的 .plist 文件。

4. 项目安装方式

使用 Homebrew 安装

brew install --cask webviewscreensaver --no-quarantine

直接下载安装

从 releases 页面下载并安装。

从源码安装

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/liquidx/webviewscreensaver/master/install-from-source.sh)"

通过以上步骤，你可以成功安装并配置 WebViewScreenSaver，享受自定义网页屏幕保护程序的乐趣。