AV1 视频查找器 (AV1 Video Finder)
这是一个跨平台 (Windows, macOS, Linux) 的 Python 脚本,用于扫描指定目录及其所有子目录,找出所有使用 AV1 视频编码的视频文件。
功能
- 递归扫描指定目录下的所有文件。
- 通过文件扩展名初步过滤出可能的视频文件。
- 使用
ffprobe
(FFmpeg 套件的一部分) 来准确识别视频文件的视频流编码。 - 输出所有检测到的 AV1 编码视频文件的完整路径。
- 显示扫描进度和最终统计结果。
先决条件
- Python 3.x: 需要安装 Python 3。你可以从 python.org 下载。
- FFmpeg: 需要在你的系统上安装 FFmpeg。脚本实际上使用的是
ffprobe
命令,它通常随 FFmpeg 一起安装。- 重要:
ffprobe
的可执行文件必须位于系统的环境变量PATH
中,这样脚本才能直接调用它。 - 检查方法: 打开你的终端或命令提示符,输入
ffprobe -version
或ffmpeg -version
。如果命令能够成功执行并显示版本信息,则表示配置正确。如果提示找不到命令,你需要将 FFmpeg 的bin
目录添加到系统的PATH
环境变量中。
- 重要:
如何使用
-
保存脚本: 将上面的 Python 代码保存为
find_av1.py
文件。 -
打开终端或命令提示符:
- Windows: 可以使用
cmd.exe
或PowerShell
。 - macOS: 使用
Terminal.app
。 - Linux: 使用你常用的终端模拟器 (如
gnome-terminal
,konsole
,xterm
等)。
- Windows: 可以使用
-
运行脚本: 使用
python
命令执行脚本,并提供要扫描的目录作为参数。python find_av1.py /path/to/your/video/directory
或者 (在 macOS/Linux 上,如果添加了执行权限
chmod +x find_av1.py
):./find_av1.py /path/to/your/video/directory
请将
/path/to/your/video/directory
替换为你要扫描的实际目录路径。- 示例 (Windows):
python find_av1.py C:\Users\YourUser\Videos
- 示例 (macOS/Linux):
python find_av1.py /home/youruser/media/movies
- 示例 (Windows):
-
查看输出: 脚本会首先检查
ffprobe
是否可用,然后开始扫描。它会实时更新当前正在检查的文件,并在找到 AV1 视频时打印其完整路径。扫描结束后,会显示总共处理的文件数和找到的 AV1 文件数。
工作原理
- 脚本接收一个目录路径作为输入。
- 使用
os.walk
(或类似方法,这里用了os.walk
来遍历目录结构) 遍历该目录及其所有子目录中的文件。 - 对于每个文件,检查其扩展名是否属于常见的视频格式 (定义在
VIDEO_EXTENSIONS
集合中)。 - 如果扩展名匹配,脚本会调用
ffprobe
命令来查询该文件的第一个视频流 (-select_streams v:0
) 的编码名称 (stream=codec_name
)。 ffprobe
的输出 (即编码名称) 被捕获。- 如果编码名称是
av1
,则该文件的路径被打印到控制台。 - 处理过程中会捕获并报告
ffprobe
执行可能发生的错误 (如文件损坏、非视频文件等),但不会中断整个扫描过程。
注意事项
- 脚本依赖于
ffprobe
来识别编码,识别的准确性取决于ffprobe
。 - 扫描大型目录或包含大量视频文件的目录可能需要较长时间,因为每个潜在的视频文件都需要调用
ffprobe
进行分析。 VIDEO_EXTENSIONS
列表包含了常见的视频格式,但可能不是最全的。如果你的 AV1 视频使用了不常见的扩展名,可以编辑脚本将该扩展名添加到列表中。- 如果文件没有视频流,或者
ffprobe
因文件损坏等原因无法读取元数据,该文件将被跳过。