ffmpegextrah/ffmpeg

FFmpeg 镜像文档

镜像概述和主要用途

FFmpeg 是一个功能强大的多媒体处理工具集，包含一系列库和命令行工具，用于处理音频、视频、字幕及相关元数据。它支持多种编解码格式、容器格式和流媒体协议，广泛应用于多媒体内容的转换、编辑、分析和流式传输。

核心功能和特性

核心库

• libavcodec：提供广泛的编解码器实现，支持多种音频和视频编码格式。
• libavformat：实现流媒体协议、容器格式处理及基础 I/O 访问功能。
• libavutil：包含哈希函数、解压缩器和各类实用工具函数。
• libavfilter：通过滤镜链对解码后的音视频进行处理和修改。
• libavdevice：提供访问捕获设备和播放设备的抽象接口。
• libswresample：实现音频混音和重采样功能。
• libswscale：实现色彩空间转换和图像缩放功能。

主要工具

• ffmpeg：命令行工具，用于多媒体内容的处理、转换和流式传输。
• ffplay：轻量级多媒体播放器。
• ffprobe：简单的多媒体内容分析工具，用于检查媒体文件信息。
• 其他小型工具：如 aviocat、ismindex 和 qt-faststart 等。

使用场景和适用范围

FFmpeg 适用于多种多媒体处理场景，包括但不限于：

• 视频格式转换（如 MP4 转 AVI、FLV 转 MP3 等）
• 音频提取与处理（从视频中提取音频、调整音量、格式转换）
• 视频剪辑与编辑（裁剪、合并、添加水印）
• 流媒体处理（直播推流、拉流、转码）
• 媒体文件分析（查看编码信息、分辨率、时长等元数据）
• 批量处理多媒体文件

使用方法和配置说明

Docker 部署示例

基本运行方式

通过 Docker 运行 FFmpeg 容器，执行命令行工具：

bash
docker run --rm -v $(pwd):/workdir ffmpeg/ffmpeg [ffmpeg命令参数]

示例：转换视频格式

将当前目录下的 input.mp4 转换为 output.avi：

bash
docker run --rm -v $(pwd):/workdir ffmpeg/ffmpeg -i /workdir/input.mp4 /workdir/output.avi

示例：提取音频

从视频文件中提取音频并保存为 MP3 格式：

bash
docker run --rm -v $(pwd):/workdir ffmpeg/ffmpeg -i /workdir/input.mp4 -vn -acodec libmp3lame /workdir/output.mp3

示例：使用 ffprobe 分析媒体文件

查看媒体文件的详细信息：

bash
docker run --rm -v $(pwd):/workdir ffmpeg/ffmpeg ffprobe /workdir/input.mp4

常用参数说明

• -i：指定输入文件路径
• -o：指定输出文件路径（部分命令支持）
• -vn：禁用视频流（仅处理音频）
• -acodec：指定音频编码器（如 libmp3lame 用于 MP3 编码）
• -vcodec：指定视频编码器（如 libx264 用于 H.264 编码）

文档和资源

离线文档

容器内的 doc/ 目录包含离线文档。

在线文档

• 官方网站：[***]
• 官方 Wiki：[***]

代码示例

doc/examples 目录提供了 C 语言编码示例。

许可证

FFmpeg 代码库主要采用 LGPL 许可证，部分可选组件采用 GPL 许可证。详细信息请参考 LICENSE 文件。

贡献方式

补丁应通过 git format-patch 或 git send-email 提交至 ffmpeg-devel 邮件列表。不建议使用 GitHub Pull Request，因为其不属于官方审核流程，可能会被忽略。