Repolode
提交项目
kkroening

kkroening/ffmpeg-python

用 Python 链式调用构建并执行 FFmpeg 命令，支持复杂滤镜图。

在 GitHub 查看
Star
11,015
Fork
948
未关闭 Issue
524
最近提交
2年前

这是什么？

ffmpeg-python 是对 FFmpeg 命令行工具的纯 Python 封装。开发者不必手写冗长的 FFmpeg 参数字符串，而是通过 input、filter、output 等链式调用描述处理流程，库会生成对应的 ffmpeg 命令并执行。

它的核心优势在于复杂滤镜图。流可以被拆分、裁剪、拼接、叠加，也可以通过通用的 filter 方法调用任意 FFmpeg 滤镜。只要是有向无环图，库都能处理。执行前可以用 get_args() 或 compile() 查看生成的命令参数。

本库不负责安装 FFmpeg，需要用户自行安装并确保其在 PATH 中可用。

核心功能

  • 01通过链式 Python 调用生成 ffmpeg 命令。
  • 02支持拆分、拼接、叠加等复杂滤镜图。
  • 03通过通用 filter 方法调用任意 FFmpeg 滤镜。
  • 04可用 get_args() 或 compile() 预览生成的命令参数。
  • 05可通过 pip 安装，兼容 PATH 中的任意 FFmpeg 版本。

适用场景

  • 在 Python 数据或媒体处理流水线中批量转换视频。
  • 从视频文件生成缩略图或提取帧。
  • 通过管道将原始音视频数据读入 NumPy 数组。
  • 无需手写滤镜字符串即可完成多输入叠加或拼接。

快速上手

  1. 1

    自行安装 FFmpeg（例如通过包管理器）

  2. 2

    从 PyPI 安装 Python 包

    pip install ffmpeg-python
  3. 3

    使用链式接口水平翻转视频

使用前须知

  • FFmpeg 需要单独安装，本包不会自动安装。
  • 某些滤镜会丢弃音频流，可能需要使用 audio/video 操作符。

标签

#ffmpeg#video#audio#multimedia#wrapper#video-processing

常见问题

ffmpeg-python 是什么？
用 Python 链式调用构建并执行 FFmpeg 命令，支持复杂滤镜图。 ffmpeg-python 是对 FFmpeg 命令行工具的纯 Python 封装。开发者不必手写冗长的 FFmpeg 参数字符串，而是通过 input、filter、output 等链式调用描述处理流程，库会生成对应的 ffmpeg 命令并执行。
ffmpeg-python 可以免费使用吗？用的什么许可证？
ffmpeg-python 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
ffmpeg-python 还在维护吗？
超过半年未提交。ffmpeg-python 最近一次提交是在 2024年8月4日。
ffmpeg-python 适合用来做什么？
在 Python 数据或媒体处理流水线中批量转换视频。 从视频文件生成缩略图或提取帧。 通过管道将原始音视频数据读入 NumPy 数组。 无需手写滤镜字符串即可完成多输入叠加或拼接。
ffmpeg-python 怎么安装和运行？
自行安装 FFmpeg（例如通过包管理器） 从 PyPI 安装 Python 包: pip install ffmpeg-python 使用链式接口水平翻转视频
在哪里获取 ffmpeg-python？
源代码和安装说明在 GitHub 上：https://github.com/kkroening/ffmpeg-python

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目