xtraffmpegv/ffmpeg

FFmpeg 镜像文档

镜像概述和主要用途

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

核心功能和特性

核心库

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

命令行工具

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

使用场景和适用范围

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

• 音视频格式转换（如MP4转AVI、FLAC转MP3等）
• 视频剪辑与编辑
• 流媒体传输（如直播推流、拉流处理）
• 媒体文件信息分析
• 音视频压缩与质量调整
• 批量处理多媒体文件

使用方法和配置说明

Docker部署示例

基本音视频转换（docker run）

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

• --rm：容器运行结束后自动删除
• -v $(pwd):/workdir：挂载当前目录到容器内/workdir，用于文件访问
• ffmpeg -i input.mp4 output.avi：将input.mp4转换为output.avi

媒体文件信息分析（ffprobe）

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

媒体播放（ffplay，需图形界面支持）

bash
docker run --rm -v $(pwd):/workdir -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix docker.xuanyuan.run/ffmpeg:latest ffplay input.mp4

• -e DISPLAY=$DISPLAY：传递显示环境变量
• -v /tmp/.X11-unix:/tmp/.X11-unix：挂载X11 socket实现图形显示

文档与资源

• 离线文档：位于镜像内doc/目录
• 在线文档：https://ffmpeg.org和https://trac.ffmpeg.org
• 代码示例：位于镜像内doc/examples目录

许可证

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

贡献方式

补丁需通过git format-patch或git send-email提交至ffmpeg-devel邮件列表。不建议使用Github pull requests，因其不属于官方审核流程。