PySceneDetect提示FFmpeg不可用但系统已安装FFmpeg的问题咨询

问题根源 #

PySceneDetect 不依赖 ffmpeg-python 库完成FFmpeg可执行文件的查找，它有独立的二进制检测逻辑，你给ffmpeg-python传入的cmd参数仅对ffmpeg-python本身的调用生效，PySceneDetect完全不会读取这个配置，自然识别不到你指定路径下的FFmpeg。

步骤1：获取FFmpeg的实际可执行路径 #

在你可以正常调用FFmpeg的终端中执行以下命令，拿到FFmpeg的绝对路径：

# Linux/macOS 执行
which ffmpeg

# Windows 执行
where ffmpeg

如果你平时用的是当前目录下的./ffmpeg，直接用这个路径也可以，但更推荐用绝对路径避免工作目录不匹配的问题。

步骤2：两种方式让PySceneDetect识别到FFmpeg #

方式1：代码内直接指定路径（最灵活，推荐） #

不管是可用性检测还是视频切分接口，PySceneDetect都原生支持传入ffmpeg_path参数手动指定二进制位置，不需要修改系统配置：

from scenedetect.video_splitter import is_ffmpeg_available, split_video_ffmpeg

# 替换成你上一步拿到的FFmpeg实际路径
FFMPEG_ABS_PATH = "/your/actual/path/to/ffmpeg"

# 检测可用性，此时会返回True
print(is_ffmpeg_available(ffmpeg_path=FFMPEG_ABS_PATH))

# 调用切分接口时传入路径参数即可正常运行
split_video_ffmpeg(
    input_video_path="vi0.mp4",
    scene_list=scene_list,
    show_progress=False,
    ffmpeg_path=FFMPEG_ABS_PATH # 关键传参
)

注：该参数在PySceneDetect v0.6及以上版本均支持，不需要修改库源码。

方式2：全局配置，无需每次代码传参 #

如果不想每次调用接口都传路径，可以选以下任意一种永久配置方式：

• 将FFmpeg所在的文件夹路径加入系统PATH环境变量，重启Python解释器后PySceneDetect会自动扫描到FFmpeg。注意如果你用conda/venv等虚拟环境，需要确认虚拟环境继承了系统PATH，或者把FFmpeg路径加到虚拟环境的PATH配置里。
• 编写PySceneDetect用户配置文件：
  • Linux/macOS：在用户根目录下创建/编辑 ~/.scenedetect.cfg
  • Windows：在C:\Users\你的用户名\目录下创建/编辑 scenedetect.cfg
    在文件中添加如下配置段：

  [split-video]
  ffmpeg-path = /your/actual/path/to/ffmpeg
  

常见踩坑点 #

• 安装ffmpeg-python不等于安装FFmpeg：前者只是FFmpeg的Python调用封装，本身不包含FFmpeg二进制文件，PySceneDetect检测的是独立的可执行文件，和ffmpeg-python是否安装没有关系。
• 尽量不要用相对路径指定FFmpeg，除非你能100%确认Python进程运行时的工作目录和FFmpeg相对路径匹配，否则很容易出现路径找不到的问题，优先用绝对路径。
• 如果是在IDE（比如PyCharm、VSCode）里运行代码，要确认IDE启动的Python进程继承了你配置的系统PATH，很多时候IDE不会加载终端里的自定义PATH配置，导致终端能找到FFmpeg但IDE里运行找不到。

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