在Python中用FFmpeg实现视频镜头分割并提取帧与时间戳

问题根源 #

你遇到的「无法找到'0'的合适输出格式」错误，本质是subprocess参数传递方式错误。终端里的命令依赖shell处理嵌套引号和参数拆分，但直接在Python里按字符串传参时，subprocess会错误地将-vsync后的0识别为独立的输出文件，而非参数值。

正确实现方案 #

1. 推荐：使用参数列表（shell=False，安全无引号问题） #

这种方式不需要处理嵌套引号，subprocess会自动正确解析每个参数，同时避免shell注入风险：

import subprocess
import re
import os

# 确保输出目录存在，避免FFmpeg写入失败
os.makedirs('frames', exist_ok=True)

# 将FFmpeg命令拆分为参数列表，无需额外嵌套引号
cmd = [
    'ffmpeg',
    '-i', 'input_vid.mp4',
    '-filter:v', "select='gt(scene,0.1)',showinfo",
    '-vsync', '0',
    'frames/%05d.jpg'
]

# 执行命令，捕获stderr（showinfo的输出默认到stderr），忽略stdout冗余内容
result = subprocess.run(
    cmd,
    stderr=subprocess.PIPE,
    stdout=subprocess.DEVNULL,
    text=True
)

# 用正则从stderr中提取pts_time时间戳
timestamp_regex = re.compile(r"pts_time:(\d+\.?\d*)")
frame_timestamps = timestamp_regex.findall(result.stderr)

# 输出提取到的时间戳
print("镜头起始帧时间戳：", frame_timestamps)

2. 可选：使用shell=True（需处理引号转义） #

如果坚持用shell解析命令，需要对filter参数里的引号进行转义，注意这种方式存在shell注入风险，仅在文件名无特殊字符时使用：

import subprocess
import re
import os

os.makedirs('frames', exist_ok=True)

# 转义filter参数中的单引号，确保shell正确解析
cmd_str = 'ffmpeg -i input_vid.mp4 -filter:v "select=\'gt(scene,0.1)\',showinfo" -vsync 0 frames/%05d.jpg'
result = subprocess.run(
    cmd_str,
    shell=True,
    stderr=subprocess.PIPE,
    stdout=subprocess.DEVNULL,
    text=True
)

timestamp_regex = re.compile(r"pts_time:(\d+\.?\d*)")
frame_timestamps = timestamp_regex.findall(result.stderr)
print("镜头起始帧时间戳：", frame_timestamps)

关键注意事项 #

• 必须提前创建frames目录，否则FFmpeg会因无法写入文件而报错
• showinfo滤镜的输出默认流向stderr，因此要捕获stderr而非stdout
• 如果FFmpeg不在系统PATH中，需要替换为完整路径（比如/usr/bin/ffmpeg或C:\ffmpeg\bin\ffmpeg.exe）

内容的提问来源于stack exchange，提问作者ludog