video-frames 是一个基于 PyAV 开发的命令行视频处理工具，专为高效提取视频帧和进行媒体文件压缩而设计。该工具支持多种灵活的帧提取方式，包括按帧号、时间点提取单帧，以及批量提取多帧或按时间间隔采样提取。此外，它还具备查看视频元信息、压缩视频为 H.264 格式以及将图片批量转换为 WebP 等高级功能。整个系统采用 Python 虚拟环境隔离依赖，并通过自动化安装脚本简化部署流程，确保在 Windows、macOS 和 Linux 平台上均可稳定运行。借助多线程加速机制，video-frames 在处理大规模视频或图像目录时仍能保持较高效率，非常适合需要快速处理多媒体内容的开发者与内容创作者。
核心功能特点
- 支持按帧号或时间点精准提取单帧
- 可批量提取连续帧或按时间间隔采样
- 提供视频元信息查看功能（时长、分辨率、编码等）
- 内置视频压缩功能，支持 H.264 重新编码
- 可将图片批量转换为压缩率更高的 WebP 格式
- 支持递归目录处理和跨平台使用
适用场景
video-frames 适用于多种实际应用场景，尤其适合需要频繁操作视频帧或优化媒体存储的场景。例如，在构建视频库或内容管理系统时，可通过 dirfirst 命令递归提取所有视频的首帧作为缩略图，并自动压缩为 WebP 格式以节省空间。对于视频分析任务，如动作检测或关键帧识别，sample 模式可按固定时间间隔（如每 5 秒）提取一帧，生成关键帧序列供后续处理。在媒体发布前，vcompress 功能允许用户以不同质量预设对视频进行压缩，平衡画质与文件大小，特别适合上传至网络或用于存档备份。此外，compress 子命令可用于将大量 JPEG/PNG 图片批量转为 WebP，显著减少存储占用，同时保持视觉质量。无论是个人项目还是自动化流水线，video-frames 都能通过简洁的命令行接口实现高效、可靠的媒体处理。