awesomeffmpegs/ffmpeg

FFmpeg 镜像文档

镜像概述和主要用途

FFmpeg是一组用于处理多媒体内容（如音频、视频、字幕及相关元数据）的库和工具的集合。该Docker镜像封装了FFmpeg的核心功能，提供便捷的多媒体处理环境，适用于格式转换、流媒体处理、音视频编辑等场景。

核心功能和特性

核心库

• libavcodec：提供多种编解码器的实现
• libavformat：实现流媒体协议、容器格式和基本I/O访问
• libavutil：包含哈希器、解压缩器和杂项实用函数
• libavfilter：通过滤镜链修改解码后的音频和视频
• libavdevice：提供访问捕获和播放设备的抽象接口
• libswresample：实现音频混合和重采样例程
• libswscale：实现颜色转换和缩放例程

工具集

• ffmpeg：命令行工具箱，用于操作、转换和流媒体处理多媒体内容
• ffplay：简约的多媒体播放器
• ffprobe：用于检查多媒体内容的简单分析工具
• 其他小工具：如aviocat、ismindex和qt-faststart

使用场景和适用范围

• 多媒体格式转换（如MP4转AVI、音频格式转换等）
• 流媒体处理和直播推流
• 音视频编辑（添加滤镜、裁剪、合并等）
• 多媒体文件分析和信息提取
• 开发集成（作为依赖库用于音视频处理应用开发）

使用方法和配置说明

基本使用（Docker Run）

通过Docker运行FFmpeg命令的基本格式：

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

参数说明：

• --rm：容器退出后自动删除
• -v $(pwd):/workdir：将当前目录挂载到容器内的/workdir目录，实现文件共享

常用命令示例

示例1：转换视频格式

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

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

示例2：提取音频

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

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

示例3：视频压缩

调整视频比特率以减小文件大小：

bash
docker run --rm -v $(pwd):/workdir ffmpeg ffmpeg -i /workdir/input.mp4 -b:v 1M /workdir/compressed.mp4

示例4：使用ffprobe分析媒体信息

查看视频文件的详细编码信息：

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

文档和示例

• 离线文档：位于容器内的/doc/目录，可通过挂载查看
• 在线文档：FFmpeg官网 和 FFmpeg Wiki
• 编码示例：位于容器内的/doc/examples目录，包含C语言示例代码

许可证

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

贡献

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