2025-03-08
编程
00
请注意,本文编写于 50 天前,最后修改于 50 天前,其中某些信息可能已经过时。

目录

安装
基本用法示例
1. 视频转码
2. 提取音频轨道
3. 视频剪辑
4. 添加水印
更多功能
注意事项

ffmpeg-python 是一个强大的库,它为 FFmpeg 提供了高层次的 Python 绑定,使得你可以通过编写 Python 代码来执行复杂的音视频处理任务。

安装

首先,你需要确保系统中已经安装了 FFmpeg。如果还没有安装,请根据你的操作系统进行安装:

  • macOS: 可以通过 Homebrew 安装:
    bash
    brew install ffmpeg
  • Linux: 使用包管理器安装,例如在 Ubuntu 上:
    bash
    sudo apt-get update sudo apt-get install ffmpeg
  • Windows: 下载并安装 FFmpeg 的 Windows 版本,并将其添加到系统的 PATH 环境变量中。

然后,使用 pip 安装 ffmpeg-python

bash
pip install ffmpeg-python

基本用法示例

1. 视频转码

将一个视频文件从一种格式转换为另一种格式:

python
import ffmpeg input_file = 'input.mp4' output_file = 'output.avi' # 使用 ffmpeg-python 进行转码 ( ffmpeg .input(input_file) .output(output_file) .run() )

2. 提取音频轨道

从视频文件中提取音频轨道并保存为 MP3 文件:

python
import ffmpeg input_file = 'input.mp4' output_file = 'output_audio.mp3' # 提取音频轨道 ( ffmpeg .input(input_file) .output(output_file, format='mp3') .run() )

3. 视频剪辑

截取视频中的某一段并保存为新文件:

python
import ffmpeg input_file = 'input.mp4' output_file = 'output_clip.mp4' start_time = '00:00:10' # 开始时间 duration = '00:00:30' # 持续时间 # 截取视频片段 ( ffmpeg .input(input_file, ss=start_time, t=duration) .output(output_file) .run() )

4. 添加水印

在视频上添加一个图片作为水印:

python
import ffmpeg input_video = 'input.mp4' input_watermark = 'watermark.png' output_file = 'output_with_watermark.mp4' # 添加水印 video = ffmpeg.input(input_video) watermark = ffmpeg.input(input_watermark) ( ffmpeg .overlay(video, watermark) .output(output_file) .run() )

更多功能

ffmpeg-python 支持许多其他功能,如视频合并、音频混合、字幕添加等。你可以参考 官方文档 获取更多详细信息和高级用法示例。

注意事项

  • 确保 FFmpeg 已正确安装并在系统路径中可用。
  • 在运行长时间的任务时,考虑捕获和处理可能发生的异常。
  • 对于复杂的操作链,可以利用 ffmpeg-python 提供的流式 API 来构建更复杂的流程。