Video2X 新手实操指南：免费把模糊视频放大到 4K、补帧到 60fps 的完整命令清单

【免费下载链接】video2xA machine learning-based video super resolution and frame interpolation framework. Est. Hack the Valley II, 2018.项目地址: https://gitcode.com/GitHub_Trending/vi/video2x

Video2X 是免费开源、本地运行的视频超分辨率与帧插值框架（当前版本 6.4.0）。它解决"老视频模糊、卡顿、分辨率上不去"的痛点：跑完本文命令，你会得到一份 4 倍放大或 2 倍帧率的成片，且处理期间不额外占用磁盘空间。

🎬 一、你带着什么素材来

先看三个场景，确认你的素材在这里有解法，后面的命令都是为它们准备的：

• 老动漫：480p 甚至更低，线条糊、色块脏，想要 1080p/4K 级别清晰度；
• 真人实拍：噪点明显、放大后颗粒感重，需要去噪和放大一起做；
• 游戏录像或快切片段：24fps 看起来卡顿，想补齐中间帧变成 48/60fps。

✅ 二、动手前先过一遍自检表

这一节能让你 30 秒判断能不能开工，不满足哪条就看对应结论。

🚀 三、从装到出片的最短路径

按顺序跑完三步，你会得到第一条成功放大的成片。

第 1 步：安装。Windows 下载官方安装程序（6.4.0 安装版），双击装完即可；Linux 三选一：

# 任意发行版：发布页取 Video2X-x86_64.AppImage，加执行权限后直接运行 chmod +x Video2X-x86_64.AppImage && ./Video2X-x86_64.AppImage

Arch 系直接装 AUR 里的video2x包。源码构建先克隆仓库，再按 packaging/arch/PKGBUILD 列出的依赖安装并编译：

git clone https://gitcode.com/GitHub_Trending/vi/video2x

第 2 步：确认显卡被识别。列出系统里的 Vulkan 设备：

video2x --list-gpus

每块 GPU 会显示型号、Vulkan API 版本和驱动版本。看不到独显，说明驱动没装好，回到第二步先解决驱动。

第 3 步：跑通第一条放大命令。用 Real-ESRGAN 把视频放大 4 倍：

video2x -i input.mp4 -o output.mp4 -p realesrgan -s 4 --realesrgan-model realesr-animevideov3

-i输入、-o输出、-p处理器（模型套件），三者必填；-s是缩放倍率，只接受 2、3、4；--realesrgan-model默认就是realesr-animevideov3，这里写出来是为了让你能替换。处理中按空格暂停、按 q 中止；跑完会打印处理帧数、耗时、平均 FPS 的总结。

📚 四、场景手册：按任务对号取命令

四个任务各一条命令，照抄替换文件路径即可。

H3 动漫放大：libplacebo + Anime4K 怎么跑

适用场景：动漫画面线条干净，目标是拉满分辨率。完整命令：

video2x -i input.mp4 -o output.mp4 -w 3840 -h 2160 -p libplacebo --libplacebo-shader anime4k-v4-a+a

为什么这么配：libplacebo 不用倍率参数，必须用-w/-h直接指定目标宽高，所以目标分辨率要按原片尺寸取整数倍，避免拉伸；anime4k-v4-a+a是内置着色器里力度较高的档位，默认档位是anime4k-v4-a。

H3 真人实拍去噪放大：Real-ESRGAN 怎么选

适用场景：实拍素材噪点多、细节杂，放大容易暴露颗粒。完整命令：

video2x -i input.mp4 -o output.mp4 -p realesrgan -s 4 --realesrgan-model realesr-generalv3

为什么这么配：realesr-generalv3是通用模型，比动漫模型更适合实拍内容；跑完先抽几帧对比原片，确认倍率和模型合适再处理整片库。

H3 补帧：RIFE 怎么把 24fps 变成 48fps

适用场景：游戏录像、体育赛事、动作片段这类快速运动内容。完整命令：

video2x -i input.mp4 -o output.mp4 -p rife -m 2 --rife-model rife-UHD

为什么这么配：-m是帧率倍率，RIFE 模式下必填且最小为 2（24fps 变 48fps，30fps 变 60fps 就用-m 2）；--rife-model默认rife-v4.26，高动态高分辨率场景换rife-UHD，老动漫换rife-anime。

H3 批量处理：一个循环跑完整个目录

适用场景：同目录下要全部放大，不想一条条敲。完整命令：

for f in *.mp4; do video2x -i "$f" -o "out_${f}" -p realesrgan -s 4 --realesrgan-model realesr-generalv3 done

为什么这么配：循环体就是第三节那条命令加了文件变量，输出统一加out_前缀，避免覆盖原片。

📊 五、选型与参数速查：处理器怎么选、默认值是什么

这张表收口全部选型问题，命令里不再重复解释。

两个最容易踩的坑：libplacebo 忘给-w/-h会直接报错；rife 忘给-m同样报错，这两个是硬校验。

🧯 六、排坑问答：高频问题一次说清

问题：--list-gpus里没有我的显卡，或只有 CPU 设备。解决：先更新显卡驱动并确认其支持 Vulkan，重启终端再列一次；仍看不到就换一块支持 Vulkan 的 GPU。

问题：RIFE 补帧时转场、闪黑处画面抖动明显。解决：调--scene-thresh（场景检测阈值，默认 100，范围 0~100，100 表示两帧差异 100% 才判定切场）。阈值决定哪些帧对被当作镜头切换跳过插值，按你的素材手感微调。

问题：输出分辨率很高时处理很慢或直接失败。解决：先把-w/-h或-s降一档试跑，确认显存扛得住再拉回目标规格；多 GPU 机器可用-d指定设备序号（默认 0）。

问题：成片没有声音/字幕。解决：确认没有加--no-copy-audio-streams或--no-copy-subtitle-streams——默认会原样复制音轨与字幕，只有显式加参数才会丢弃。

问题：长视频跑到一半想停下，又不想废掉进度。解决：按空格可暂停/恢复处理，按 q 优雅中止当前任务（不会继续写坏文件），改完参数重新跑即可。

🧭 七、下一步：验证环境与继续深入

• 命令行全量参数：docs/book/src/running/command-line.md，跑video2x --help也能看到同样的选项与示例；
• 核心流水线源码（解码、滤波、插值、编码）：src/，架构原理见 docs/book/src/developing/architecture.md；
• 命令行工具本体（参数解析、GPU 枚举）：tools/video2x/；
• 全部模型文件（Anime4K 着色器、Real-ESRGAN、Real-CUGAN、14 组 RIFE 权重）：models/；
• 构建依赖与流程：docs/book/src/building/。

收尾动作：剪一段 10 秒的旧视频，按第三节的命令跑一遍，抽帧对比原片；结果满意后，再把第四节的批量循环投到整个片库。

【免费下载链接】video2xA machine learning-based video super resolution and frame interpolation framework. Est. Hack the Valley II, 2018.项目地址: https://gitcode.com/GitHub_Trending/vi/video2x