video2x:AI视频超分辨率与插帧修复部署指南
官方信息
| 项目名称 | video2x |
| 仓库地址 | https://github.com/k4yt3x/video2x |
| 官方网站 | GitHub 主页 |
| 最新更新 | 2025-01-24(v6.4.0) |
| 项目定位 | 基于深度学习的视频/GIF/图像无损放大与插帧工具,集成 Waifu2x、Real-ESRGAN、DAIN 等多种 SOTA 算法,把老视频修复到 4K 60帧 |
项目背景
家里珍藏的老电影、十几年前的动画片、网上下载的低分辨率游戏录屏,画面模糊、帧率低(24帧甚至15帧),观感很差。传统视频播放器的"倍帧"功能只是简单插黑帧,效果有限。真正的 AI 视频修复需要逐帧超分 + 智能插帧两个步骤。
video2x 就是把这个完整链路打包好的开源工具。它自动调用 FFmpeg 把视频拆成帧序列,逐帧用 Real-ESRGAN/Waifu2x 放大分辨率,再用 RIFE/DAIN 算法在帧之间插入新生成的中间帧提升帧率,最后重新合成带音频的高清视频。整个过程全自动,你只需要指定输入视频和目标分辨率/帧率。
项目在 GitHub 上收获超过 18K Star,是视频修复领域最知名的开源工具之一,特别适合老动画修复、老电影数码化、游戏录屏增强等场景。
核心特性
- 多超分算法:集成 Real-ESRGAN、Waifu2x、SRCNN、FSRCNN、EDSR 等多种模型
- 智能插帧:支持 RIFE、DAIN、CAIN 等插帧算法,24帧→60帧丝般顺滑
- 图像/GIF 支持:不仅视频,也能处理 GIF 动图和单张图片
- Windows 绿色版:官方提供打包好的 Windows 可执行文件,无需配环境
- GUI 图形界面:提供 Qt GUI 界面,可视化选择模型和参数
- GPU 加速:支持 CUDA、Vulkan、Apple Metal,N 卡速度最快
- 音频保留:自动从原视频提取音频并合成到输出视频
- 分块处理:大视频自动分块,显存不够也能跑
环境要求
- 操作系统:Windows 10+/Linux(推荐 Ubuntu 22.04)
- Python:3.10+(源码部署时需要)
- 显卡:NVIDIA GPU 推荐(6GB 显存以上,CUDA 11.8+)
- 内存:最低 16GB,推荐 32GB(视频拆帧很占内存)
- 磁盘空间:处理 1 部电影约需 50GB 临时空间
- 系统依赖:FFmpeg(必须)
详细部署步骤
方式一:Windows 便携版(推荐普通用户)
- 前往 Releases 页面
- 下载最新版 Windows 包:video2x-x.x.x-windows64.7z(约 200MB)
- 用 7-Zip 解压到任意目录(路径不要有中文和空格)
- 目录结构说明:
video2x.exe- 命令行主程序video2x_gui.exe- 图形界面ffmpeg/- 内置 FFmpeg,无需单独安装models/- 内置各种 AI 模型权重
- 双击
video2x_gui.exe即可启动图形界面
方式二:pip 安装(Linux/macOS)
# 创建虚拟环境
conda create -n video2x python=3.10 -y
conda activate video2x
# 安装 PyTorch(CUDA 11.8)
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu118
# 安装 video2x
pip install video2x
# 验证安装
video2x --version方式三:源码部署
# 克隆仓库
git clone https://github.com/k4yt3x/video2x.git
cd video2x
# 创建环境
conda create -n video2x python=3.10 -y
conda activate video2x
# 安装 PyTorch
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu118
# 安装依赖
pip install -r requirements.txt
# 安装 FFmpeg(Ubuntu)
sudo apt update && sudo apt install -y ffmpeg
# 运行
python -m video2x --version方式四:Docker 部署
# 拉取官方镜像
docker pull k4yt3x/video2x:latest
# 运行(挂载视频目录)
docker run --gpus all -v /path/to/videos:/videos k4yt3x/video2x \
-i /videos/input.mp4 \
-o /videos/output.mp4 \
-p realesrgan \
-s 2x使用方法
GUI 图形界面使用
- 双击
video2x_gui.exe启动 - Input Video:选择要处理的视频文件
- Output Video:设置输出路径
- Processor:选择超分算法(推荐 realesrgan)
- Scale:选择放大倍数(2x/4x)
- 可选:勾选"Enable Frame Interpolation"启用插帧,选择 rife 算法,目标帧率设为 60
- 点击"Start"开始处理
- 处理时间取决于视频长度和硬件,一部 1 小时电影在 RTX 3060 上约需 2~4 小时
命令行使用示例
# 基础:用 RealESRGAN 把视频放大 2 倍
video2x -i input.mp4 -o output.mp4 -p realesrgan -s 2
# 高级:放大 2 倍 + RIFE 插帧到 60fps
video2x -i input.mp4 -o output.mp4 \
-p realesrgan -s 2 \
-ap rife -t 60
# 处理 GIF 动图
video2x -i input.gif -o output.gif -p waifu2x -s 2
# 指定 GPU 设备
video2x -i input.mp4 -o output.mp4 -p realesrgan -s 2 -g 0
# 参数说明:
# -i 输入文件
# -o 输出文件
# -p 超分处理器(waifu2x/realesrgan/filter/othersr)
# -s 放大倍数
# -ap 插帧算法(rife/dain/cain)
# -t 目标帧率
# -g GPU 编号常见问题 FAQ
Q1:处理一部电影要多久?
A:以 RTX 3060 为例,1 小时视频用 RealESRGAN 2x 约需 2 小时,加 RIFE 插帧到 60fps 约需 4 小时。CPU 模式会慢 10 倍以上,不推荐。
Q2:处理中途报错"out of memory"?
A:超分和插帧都很吃显存。可以在命令行加 --tile-width 512 --tile-height 512 分块处理,降低单次显存占用。
Q3:输出视频没有声音?
A:video2x 默认会自动复制原视频音轨。如果没声音,检查 FFmpeg 是否正确安装(Windows 便携版已内置),并确认原视频有音轨。
Q4:动漫视频用哪个模型?
A:推荐用 waifu2x 或 realesr-animevideov3 模型,专门针对动画线条优化,比通用 RealESRGAN 效果好很多。
Q5:支持 NVIDIA 以外的显卡吗?
A:源码版支持 Vulkan 后端,AMD 显卡可通过 Vulkan 运行。Apple Silicon Mac 支持 MPS 后端,但 Windows 便携版主要针对 N 卡优化。
跳转链接
- GitHub 仓库:https://github.com/k4yt3x/video2x
- Releases 下载:https://github.com/k4yt3x/video2x/releases
- Waifu2x 项目:https://github.com/nagadomi/waifu2x
- RIFE 插帧:https://github.com/megvii-research/ECCV2022-RIFE