ebsynth_utility

环境要求

• 已安装可正常运行的 AUTOMATIC1111 Stable Diffusion WebUI
• 已为本机操作系统安装 ffmpeg
• 已安装 EbSynth（https://ebsynth.com/）
• 建议安装 ControlNet 扩展（视频编辑必备，多 ControlNet 的 canny + normal map 较合适）
• 准备几秒钟的短视频作为首次测试素材

安装与启动步骤

1. 1安装 ffmpeg

   从 ffmpeg 官网下载并安装对应操作系统的版本，确保命令行可直接调用；README 只要求安装，未指定具体安装包管理命令。

2. 2安装 EbSynth

   访问 https://ebsynth.com/ 下载并安装 EbSynth，本插件依赖它完成关键帧风格迁移合成。

3. 3安装 ControlNet（推荐）

   在 WebUI 的 Extensions 标签中用 Install from URL 安装 sd-webui-controlnet，作者确认装齐后本扩展全部功能正常。

4. 4安装本扩展

   打开 WebUI 的 Extensions 标签，选择 Install from URL，粘贴 https://github.com/s9roll7/ebsynth_utility 后点击安装并重启 WebUI。

5. 5配置项目与视频

   新建一个空目录作为项目目录，切换到 [Ebsynth Utility] 标签，填写 Project directory 与 Original Movie Path，首次请用几秒短视频。

6. 6按阶段执行处理

   选择 stage 1 并点击 Generate，随后从 stage 1 依次执行到 stage 7；中途进度不显示在 WebUI，请查看控制台输出。

7. 7确认完成

   WebUI 中出现 “completed.” 字样即表示当前阶段完成；如最新版 WebUI 报错，可把图像拖到 img2img 主界面。

关键配置

如何确认成功

WebUI 界面显示 “completed.”，同时控制台可看到各阶段处理进度输出，即表示执行成功。

常见问题

注意事项

• 必须从 stage 1 按顺序执行到 stage 7，不能跳步。
• 处理过程较慢，耐心等待控制台完成输出。
• Project directory 建议使用新建的空目录，避免与旧结果混淆。
• 首次使用请用短视频验证流程，避免长时间等待后才发现参数有误。