FFT — FFmpeg AV1 Transcoder

FFT 是一个面向 AV1 转码工作流的本地 Web 工具，制作这个软件的目的，是在硬盘价格上涨的当下，帮助大家通过更高效的视频压缩节约硬盘空间。它把目录监控、文件对比、在线调用、预设管理、硬件能力探测、跑分记录和报告导出放在同一个界面里，适合在个人电脑、工作站或家庭局域网内批量管理视频转码任务。

后端使用 Go、Gin、SQLite，前端使用 React、TypeScript、Tailwind CSS。核心转码由本机或容器内的 FFmpeg / ffprobe 完成。

• 目录监控：按任务管理源目录和输出目录，支持手动执行、自动扫描、新文件自动转码和任务报告。
• 文件管理：左右对比源文件与 AV1 输出文件，按“保持不动 / 转码新增 / 强制转码”过滤并批量选择。
• 在线调用：拖拽上传视频，选择本机可用预设后转码，完成后直接从浏览器下载结果。
• 预设系统：内置 CPU、NVIDIA、Intel、AMD 预设分类，自动隐藏当前机器不可用的编码方式。
• AV1 工作流：支持 SVT-AV1、libaom-av1、rav1e、Intel QSV、NVIDIA NVENC、AMD AMF 等编码器。
• 硬件探测：展示 CPU、内存、GPU、硬件编码器、FFmpeg 编码器能力和 GPU 负载。
• 实时进度：任务列表、控制台、文件管理页联动展示转码进度和单文件状态。
• 跑分与排行：记录本机编码器测试结果，并按编码器类别展示排行榜。
• 报告导出：任务完成后可生成 PDF 报告，便于归档或对比。
• 本地持久化：SQLite 保存目录监控、预设、任务、跑分和历史状态，后端重启不会清空控制台数据。
• 局域网访问：默认监听 0.0.0.0:8166，同一局域网设备可访问服务地址。

GitHub Release 会提供这些产物：

桌面发布包默认会在启动后打开浏览器。Windows 如果首次运行被系统拦截，请允许本程序访问本机网络；局域网访问还需要防火墙放行 8166 端口。

保存为 docker-compose.yml：

services:
  fft-go:
    container_name: fft-go
    image: ghcr.nju.edu.cn/limbuntu/fft-go:latest
    # NVIDIA GPU:
    # image: ghcr.nju.edu.cn/limbuntu/fft-go:gpu
    # Intel GPU:
    # image: ghcr.nju.edu.cn/limbuntu/fft-go:intel
    restart: unless-stopped
    ports:
      - "8166:8166"
    volumes:
      - /your/media/path:/data
      - ./fft-go/output:/output
      - ./fft-go/data:/app/data
    environment:
      - FFT_HOST=0.0.0.0
      - FFT_PORT=8166
      - FFT_DATA_DIR=/app/data
      - FFT_CACHE_DIR=/app/data/cache
      - FFT_DB=/app/data/fft.db
      - FFT_LOG_FILE=/app/data/logs/fft.log
    networks:
      - fft-network

    # Intel GPU:
    # devices:
    #   - /dev/dri:/dev/dri

    # NVIDIA GPU:
    # gpus: all

networks:
  fft-network:
    driver: bridge

启动：

docker compose up -d
open http://localhost:8166

如果需要硬件加速镜像，可以把镜像标签换成 gpu 或 intel，并按注释开启对应设备配置。是否能启用硬件编码取决于宿主机显卡、驱动、容器运行时和 FFmpeg 能力。

NVIDIA 示例：

image: ghcr.nju.edu.cn/limbuntu/fft-go:gpu

Intel 示例：

image: ghcr.nju.edu.cn/limbuntu/fft-go:intel

需要本机准备 Go、Node.js、FFmpeg 和 ffprobe。

npm install --prefix frontend
npm run server
npm run dev

后端默认监听 http://0.0.0.0:8166，前端开发服务器默认监听 http://localhost:5173/。

FFT 由本地 Web 界面、后端服务、SQLite 数据库和 FFmpeg 转码执行器组成。前端负责目录监控、文件管理、在线调用、系统信息、预设和报告等页面；后端负责硬件探测、任务调度、进度推送、历史记录和报告生成。

运行时数据默认写在项目根目录或 FFT_DATA_DIR 指定目录中：

fft.db          # SQLite 数据库
logs/fft.log    # 运行日志
cache/          # 在线调用上传与输出缓存

FFT 会根据 ffmpeg -encoders 和轻量探测结果决定哪些预设可用。某个硬件预设不显示，通常表示当前 FFmpeg、驱动或硬件不支持对应编码器。

发布包会默认打开浏览器；Docker 运行时默认不自动打开浏览器。

• 后端：Go、Gin、SQLite、WebSocket
• 前端：React 18、TypeScript、Vite、Tailwind CSS、lucide-react
• 转码：FFmpeg、ffprobe、SVT-AV1、libaom-av1、rav1e、NVENC、QSV、AMF
• 部署：桌面发布包、Docker、Docker Compose

• FFmpeg：提供核心音视频处理能力。
• ChanningHe/ffforge：前端设计与交互参考。

以 iPhone 16 Pro 拍摄的 4K 60fps HDR 视频为例（HEVC → AV1，CRF 28，Preset 8）：

注意： AV1 转码后会丢失部分元数据，请根据需要自行修改 ffmpeg 预设

• 集成视频质量评估指标（VMAF / SSIM / PSNR），转码完成后自动进行画质对比分析
• 任务列表增加详细日志输出，支持查看每个任务的完整 FFmpeg 执行日志
• 新增音频转码选项，支持独立配置音频编码器、码率、采样率等参数
• 前端界面视觉重构，优化交互体验与整体布局设计