安装
最新安装包见 Serpent Releases。
系统要求
- macOS:Apple Silicon(arm64)或 Intel(x64),macOS 11 或更高版本
- Windows:64 位 Windows 10 或 Windows 11
- Linux:64 位 x86_64 或 aarch64(发布资产为 AppImage;建议较新的发行版,两条架构都用 Ubuntu 22.04 / glibc ≥ 2.35 基线)
- 应用本身约需 500 MB;资源库数据另占空间
安装包与版本说明以 Serpent Releases 为准。
macOS
- 下载对应架构的
Serpent-darwin-arm64-<版本>-package.dmg(或 Intel 架构对应安装包)。 - 打开 DMG,将 Serpent 拖到「应用程序」。
当前开发版若未签名公证,首次打开时右键应用选择「打开」并确认。若系统仍阻止,可以在终端清除隔离属性:
xattr -cr /Applications/Serpent.app
卸载只需将应用移入废纸篓;资源库位于创建时选择的位置,不会因删除应用而删除。
Windows
- 从发布页下载 Windows 安装包
Serpent-win-x86-64-<版本>-setup.zip(解压运行内含的安装向导进行安装),或下载便携版Serpent-win-x86-64-<版本>-portable.zip(解压到任意本地目录即可直接运行)。 - 运行安装程序并按向导选择安装路径、语言等偏好完成安装。
未签名开发包可能触发 SmartScreen,请核对来源后选择「更多信息 → 仍要运行」。通过系统「设置 → 应用」卸载,卸载程序会干净移除安装文件。
Linux
- 从发布页下载与本机架构对应的 AppImage:x86_64 为
Serpent-linux-x86-64-<版本>.AppImage,aarch64 为Serpent-linux-arm64-<版本>.AppImage。 - 赋予执行权限并运行:
chmod +x Serpent-linux-x86-64-<版本>.AppImage
./Serpent-linux-x86-64-<版本>.AppImage
# aarch64 把文件名换成 Serpent-linux-arm64-<版本>.AppImage
运行依赖:
- FUSE(
libfuse2)。没有 FUSE 时加--appimage-extract-and-run。x86_64 与 aarch64 相同。 - 发布用 AppImage 内置与 macOS、Windows 相同的
ffmpeg、ffprobe和oiiotool(oiiotool含 LibRaw / OCIO)。视频预览和专业图像格式一般不需要再安装系统里的这些程序。SERPENT_FFMPEG_PATH和SERPENT_OIIO_PATH仍可改用其他路径。aarch64 安装包要等对应媒体包晋升后才会出现在 Releases。 - Debian/Ubuntu 示例:
sudo apt install libfuse2。从源码运行且还没有媒体包时,才需要系统ffmpeg。
当前 Linux 行为与限制:
- 界面沿用 Windows 风格:无边框窗口、应用内主菜单(≡)、有合成器时圆角。
- 没有系统托盘:关闭窗口会退出应用(不会像 Windows 那样隐藏到通知区域)。
- 登录时启动暂不提供。详见基本使用。
- 已在 Debian 13(X11)和嵌套 Wayland 合成器下测试;原生 Wayland 会话仍待专项验收。x86_64 与 aarch64 使用同一套限制。
- 无可用 GPU / GL 时可设置
SERPENT_SOFTWARE_GL=1启用软件 WebGL。圆角可用SERPENT_LINUX_ROUNDED_CORNERS=0/1强制关闭或开启。
卸载:删除 AppImage 文件即可。资源库目录独立于应用文件,不会随之删除。
浏览器扩展
从扩展发布页下载浏览器扩展(Chrome / Edge / Firefox),安装与使用见浏览器扩展。
升级
macOS 用新 DMG 替换应用,Windows 运行新版安装程序覆盖安装,Linux 用新版 AppImage 替换旧文件(可先保留旧文件以便回退)。资源库目录和用户配置独立于应用安装目录,通常会保留;升级前建议备份资源库。跨版本迁移和平台差异请以发布说明为准。
应用内「帮助 → 关于 → 检查更新」在 Linux 上会按本机架构识别 Serpent-linux-x86-64-<版本>.AppImage 或 Serpent-linux-arm64-<版本>.AppImage 便携资产;下载校验后需自行 chmod +x 再运行。