ffmpeg-python

基于 Python · 开源免费，本地部署，数据完全自主可控

⭐ 9.8k Stars 💻 Python 📄 Apache-2.0 🏷 AI 9.0分

9.0AI 综合评分

ffmpeg视频处理转码Python批量处理开源

🌐 访问官网

✦ AI Skill Hub 推荐

ffmpeg-python 是 AI Skill Hub 本期精选AI工具之一。已获得 9.8k 颗 GitHub Star，综合评分 9.0 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

ffmpeg-python 是对 FFmpeg 命令行工具的 Python 封装库，让你可以用 Python 代码以流式 API 的方式构建复杂的 FFmpeg 处理管线。FFmpeg 本身是音视频处理领域最全能的开源工具，支持几乎所有视频格式的解码、编码、转码、剪辑、拼接、滤镜处理，而 ffmpeg-python 让这些能力在 Python 脚本和自动化工作流中得到更好的复用。

在实际使用中，ffmpeg-python 特别适合构建批量视频处理管线。例如将 1000 个 .mov 文件批量转换为 H.264 MP4，或者从大量视频中批量提取第一帧作为缩略图，这些任务用 subprocess 直接调用 FFmpeg 很繁琐，而 ffmpeg-python 的链式 API 可以让代码既简洁又可维护。它与 NumPy、OpenCV 的深度集成也是重要优势，可以直接在 Python 中读取视频帧进行图像处理，再输出回视频流。

📋 工具概览

FFmpeg 的 Python 绑定，用代码实现视频转码/剪辑/滤镜/合并等批量操作

ffmpeg-python 是一款基于 Python 开发的开源工具，专注于 ffmpeg、视频处理、转码等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars

⭐ 9.8k

开发语言

Python

支持平台

Windows / macOS / Linux

维护状态

持续维护，定期更新

开源协议

Apache-2.0

AI 综合评分

9.0 分

工具类型

AI工具

Forks

—

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

FFmpeg 的 Python 绑定，用代码实现视频转码/剪辑/滤镜/合并等批量操作

📌 核心特色

开源免费，支持本地部署，数据完全自主可控
活跃的 GitHub 开源社区，持续迭代更新
提供详细文档和使用示例，新手友好
支持自定义配置，灵活适配不同使用环境
可作为基础组件集成进现有技术栈或进行二次开发

🎯 主要使用场景

本地部署运行，保护数据隐私，满足合规要求
自定义集成到现有系统，扩展技术栈能力
作为开源基础组件进行商业化二次开发

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：pip 安装（推荐）
pip install ffmpeg-python

# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install ffmpeg-python

# 方式三：从源码安装（获取最新功能）
git clone https://github.com/kkroening/ffmpeg-python
cd ffmpeg-python
pip install -e .

# 验证安装
python -c "import ffmpeg_python; print('安装成功')"

📋 安装步骤说明

访问 GitHub 仓库页面
按照 README 文档完成依赖安装
根据系统环境完成初始化配置
参考官方示例或文档开始使用
遇到问题可在 GitHub Issues 中查找解答

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 基本视频转码
import ffmpeg

ffmpeg.input('input.mp4').output('output.mp4').run()

# 调整分辨率（缩放到 1280x720）
(
    ffmpeg
    .input('input.mp4')
    .filter('scale', 1280, 720)
    .output('output_720p.mp4')
    .run()
)

# 提取音频
ffmpeg.input('video.mp4').output('audio.mp3').run()

# 视频压缩（调整码率）
(
    ffmpeg
    .input('input.mp4')
    .output('output_compressed.mp4', video_bitrate='1000k', audio_bitrate='128k')
    .run()
)

# 添加水印
main = ffmpeg.input('input.mp4')
logo = ffmpeg.input('logo.png')
(
    ffmpeg
    .filter([main, logo], 'overlay', 10, 10)
    .output('output_watermark.mp4')
    .run()
)

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

# ffmpeg-python 配置文件示例（config.yml）
app:
  name: "ffmpeg-python"
  debug: false
  log_level: "INFO"

# 运行时指定配置文件
ffmpeg-python --config config.yml

# 或通过环境变量配置
export FFMPEG_PYTHON_API_KEY="your-key"
export FFMPEG_PYTHON_OUTPUT_DIR="./output"

⚡ 核心功能