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