一条命令搞定视频提取PPT：extract-video-ppt 从安装到出片只要 30 秒

一条命令搞定视频提取PPT：extract-video-ppt 从安装到出片只要 30 秒

【免费下载链接】extract-video-pptextract the ppt in the video项目地址: https://gitcode.com/gh_mirrors/ex/extract-video-ppt

30 秒出第一份 PDF：装好就能跑

上周老板丢给我一段 90 分钟的内训视频，让我"把课件发一份"。课件就是视频里那份 PPT。手动截图、重命名、拼 PDF 要磨很久，用 extract-video-ppt 做视频提取PPT：扫画面、自动截新页、拼出能打印的 PDF。

上面这张就是工具实际截下来的一帧——文件名里直接写着时间点和相似度数值，事后翻查定位很方便。

命令一共就两条：

pip install extract-video-ppt evp ./out ./my_video.mp4

第一行安装，第二行开跑。./out是输出目录（会自动创建），最后一个参数是视频路径；装没装好跑一下evp --help，能看到帮助就万事具备。跑完输出目录里就多出一份output.pdf。想先练手，把视频换成仓库自带的 demo 素材即可。

它是怎样"认"出新页面的：帧间相似度在起作用 🔍

它按每秒抽 1 帧的节奏干活，并且是拿"上一次被保存下来的画面"当参照，问：这一帧和它差多少？两张图缩到同一大小，比对亮度直方图，得出 0~1 的相似度（算法在video2ppt/compare.py）。值越小两页差越多，落到你设的阈值以下才算真换了页、值得保存。所以激光笔划来划去截不进图，真换的那一页必定截得进去。

参数速查：四个旋钮决定出片质量 ⚙️

参数	一句话作用	默认值	什么时候该动它
--similarity	相似度阈值，低于它才保存该帧	0.6	结果页太多或太少先调它
--pdfname	输出 PDF 的文件名	output.pdf	一次处理多个视频防重名
--start_frame	从第几秒开始，时:分:秒	00:00:00	只要视频中间某一段
--end_frame	处理到第几秒为止	INFINITY（到结尾）	视频太长只取前段时

经验值按"内容怎么变"来分：

• 整页整页切换的纯 PPT 录屏：默认 0.6 就够，调高反而会把光标移动也截进来
• 讲师出镜、手和激光笔频繁入画：降到 0.5，人体晃动会被忽略，真正换页仍抓得住
• 逐条弹出要点、现场敲代码、缓慢平移：抬到 0.7~0.8，否则中间状态全被跳过

两个真实场景：两条命令覆盖常用需求 🛠️

只要中间那 40 分钟：视频很长但核心内容集中在中段，起止参数直接圈出片段，不用先剪辑。

evp --start_frame 00:05:00 --end_frame 00:45:00 ./out ./training.mp4

时间写标准时:分:秒；结束时间哪怕超过视频总时长，它也会按实际结尾跑完，不报错。

一个文件夹里 5 个培训视频批量跑：循环一遍，每个视频各得一份独立 PDF。

for v in *.mp4; do evp --pdfname "${v%.mp4}.pdf" "./out_${v%.mp4}" "./$v" done

输出目录会自动创建，不用手动 mkdir；每份视频的目录和 PDF 名各自独立，互不覆盖。

小提醒：处理期间会建一个.extract-video-ppt-tmp-data临时目录存中间帧，跑完自动清理；万一强制中断后残留，手动删掉不影响下次运行。

翻车了先看这里 🚑

1. 页要么太多要么漏了——最常见，也别怀疑程序坏了。废图多就把--similarity调低一档，漏页就调高一档，两轮就能收敛。
2. 提示start >= end can not work——开始时间不比结束时间早，把两个参数交换过来即可。
3. 提示Please check if the video url is correct——文件没读进来：先确认路径没写错，格式换成 MP4、AVI 这类常见格式；若是开始时间超出总时长，会提示video duration is not support。
4. 提示write file failed !——落盘失败，检查输出目录是否可写、磁盘剩余空间够不够。

截图、命名、拼 PDF 这种重复劳动，本来就是该交给脚本的活。现在装好它，挑一段手头的讲座录像丢给evp，回来时输出目录里就躺着一份干净、能直接发人的 PDF。

【免费下载链接】extract-video-pptextract the ppt in the video项目地址: https://gitcode.com/gh_mirrors/ex/extract-video-ppt