视频补帧工具 ZeroHackz/OpenFlowFrames

OpenFlowFrames - 适用于 Windows 的视频帧插值

本项目是原始 Flowframes（由 n00mkrad 开发） 的一个分支。非常感谢他创建并维护了这个应用程序强大的核心！

这个分支是一个精简、完全免费且开源的重新构想：围绕最新的 RIFE 模型构建的现代 Python GUI——没有 Patreon 付费层级，没有付费构建版本，没有遗留代码库。

截图

主界面：选择视频或帧文件夹，选择模型和倍数，进行插值。

主界面

✨ 功能特性

* 最新的 RIFE 模型： 仓库中内置了 RIFE 4.9 到 4.26——无需外部模型服务器，完全自包含。
* 支持任意 GPU： 通过 rife-ncnn-vulkan 可在 AMD、Intel 和 NVIDIA 上运行——无需 CUDA 或 PyTorch。
* 现代 GUI： 简洁的 CustomTkinter 深色模式界面——除 Python 外无需额外安装。
* 视频或帧文件夹输入： 可对视频文件进行插值，也可对包含 PNG/JPG/WebP 帧的目录使用自定义输入帧率进行插值。
* MP4 或 PNG 输出： 编码为 H.264 MP4（保留音频），或将插值后的帧导出为 PNG 序列。
* 稳健的帧处理： 混合分辨率以及 alpha/16 位 PNG（在 AI 生成的帧中很常见）会被自动规范化。
* 便携式 Windows 可执行文件： 使用一个脚本即可构建自包含的便携式应用——目标机器上无需安装 Python。
* 无商业化： 完全免费；没有 Patreon/PayPal 集成。

💻 使用方法（简单方式）

Python GUI（推荐）：

1. 克隆此仓库：
git clone https://github.com/ZeroHackz/OpenFlowFrames.git

2. 双击 launcher-gui.bat——它会在首次运行时设置虚拟环境并启动 GUI。

便携式构建：

运行 build-portable.bat。dist/ 中的结果是完全自包含的：

dist/
OpenFlowFramesPortable.exe
packages/av/ (ffmpeg)
packages/rife-ncnn/ (interpolator + bundled RIFE models)

将 dist 文件夹复制到任意位置，然后双击 exe 即可。

工作原理

1. ffprobe 读取输入帧率和帧数（或者你为帧文件夹提供 FPS）。
2. ffmpeg 提取帧（对于帧文件夹输入则跳过此步骤）。
3. rife-ncnn-vulkan 插值到 frames × factor。
4. ffmpeg 以倍增后的帧率编码 H.264，并复制原始音频——或者将帧导出为 PNG。

⌨️ 无界面 CLI

同一引擎也可在没有 GUI 的情况下运行——可用于脚本、CI 或代理：

python cli.py --probe --input C:\clips\dance.mp4
python cli.py --input C:\clips\dance.mp4 --factor 2 --model "RIFE 4.9" --output out.mp4
python cli.py --input C:\clips\frames --fps 24 --factor 4 --out-mode png --output out_frames

🤖 DeepSeek Harness 插件

此仓库同时也是一个 DeepSeek Harness (dsh) 插件包——将其安装到 dsh 配置文件中，代理即可通过两个工具直接对视频进行插值：
* flowframes_probe — 检查视频或帧目录（分辨率、fps、帧数、音频）。
* flowframes_interpolate — 以无头模式运行 RIFE 插帧（带音频的 MP4，或 PNG 帧序列）。可在 CPU 或任意 GPU 上运行——AMD、Intel 或 NVIDIA，无需 CUDA。

dsh plugin add github:ZeroHackz/OpenFlowFrames

运行 dsh 的机器上的要求：Python 3.10+（或设置 OPENFLOWFRAMES_PYTHON）。随附的 packages/rife-ncnn 模型文件随仓库一起提供，因此无需下载模型。

给 agent 的示例提示词

* 用 RIFE 4.9 将 E:\clips\dance.mp4 插帧到 60fps，并保存为 dance-60fps.mp4
* 这个 AI 生成的帧文件夹是 24fps 的——制作一个平滑的 4 倍版本，然后将其导出为 MP4
* 检查 E:\clips 中的每个视频，并列出它们的 fps 和帧数
* 将这个 24fps 的片段转换为 120fps 的慢动作素材，然后对前景进行抠像（与 GUI-SAM2Matting 插件配合使用）

致谢

- Flowframes，作者 n00mkrad——本分支所基于的原始应用程序
- RIFE，作者 hzwer
- rife-ncnn-vulkan，作者 nihui
- FFmpeg