Documentation

使用文档

这里整理了 12 种工具说明、系统要求与源码运行方式。

12 种常用工具

从「更多」页面入口网格选择所需工具，进入功能页填写参数后执行。工具任务复用主任务队列，统一显示进度与状态。

音频提取

从视频提取音轨，转为 MP3 / AAC / WAV / Opus / Vorbis / FLAC

视频截图

按时间点截取单帧画面，支持 PNG / JPG / WEBP

GIF 制作

视频片段转 GIF 动图

视频剪切

按时间段裁剪视频

音视频格式转换

容器与编码互转

图片格式转换

图片格式互转与质量压缩

视频拼接

合并多个视频，自动用 scale2ref + setsar 统一分辨率与 SAR

媒体信息

异步探测编码 / 码率 / 时长等详情，结构化中文展示

MS Store 徽标

一键生成 5 个微软商店徽标（720×1080、1080×1080、300×300、150×150、71×71）

字幕处理

提取 / 嵌入硬字幕 / 嵌入软字幕 / 格式转换（SRT / ASS / VTT）

音量归一化

基于 EBU R128 标准的响度与动态范围归一化

速度调整

音视频同步变速 / 仅视频 / 仅音频，支持 0.25×–8×+

系统要求

操作系统：支持 Windows 10/11（推荐）、macOS 10.15+ 与 Linux，三大平台原生运行。
运行环境：Python 3.9 及以上版本，推荐使用 uv 进行极速依赖管理。
FFmpeg：需单独安装并加入系统 PATH，应用启动时自动检测路径，也可在「设置」页面手动指定。
硬件加速：可选配备 GPU（NVIDIA / Intel / AMD / Apple），用于编码加速；建议内存 4GB 以上。

源码运行

源码运行与部署流程（开发者 / 高级用户）：

# 1. 克隆仓库
git clone --recursive https://github.com/Fairy-Oracle-Sanctuary/Easy-FFmpeg.git
cd Easy-FFmpeg

# 2. 创建并激活虚拟环境
uv venv
.venv\Scripts\activate        # Windows
source .venv/bin/activate     # Unix/macOS

# 3. 安装依赖
uv pip install -r requirements.txt
uv pip install -r requirements-win.txt   # Windows 额外依赖
uv pip install -r requirements-mac.txt   # macOS 额外依赖

# 4. 确保 ffmpeg 已安装并加入 PATH
#    或在应用「设置」页面手动指定路径

# 5. 运行应用
python Easy-FFmpeg.py