actuafilms/ffwf

FFmpeg Watch Folder 镜像文档

镜像概述

FFmpeg Watch Folder是一个基于FFmpeg的视频处理镜像，旨在自动监控指定输入目录，对其中的所有视频文件进行编码处理，并将处理完成的文件整理至输出目录。该镜像通过预设编码参数简化视频处理流程，适用于需要批量转换视频格式的场景。

核心功能与特性

• 自动监控与处理：实时监控输入目录，自动识别并处理所有视频文件
• 多预设编码支持：可通过环境变量指定多种编码预设（如HD_TV_MP4、HD_TV等）
• 结构化文件管理：输入目录需包含_DONE和_OUT两个子文件夹，用于处理完成文件的归档与临时输出
• 调试模式：支持通过DEBUG环境变量启用调试模式，限制视频处理时长为10秒

使用场景

适用于个人或小型团队的批量视频编码需求，如视频格式转换、分辨率调整等场景。注意：当前为测试版（Beta），不建议用于生产环境。

使用方法与配置说明

环境变量配置

卷挂载配置

部署示例

Docker Run 命令

bash
docker run -d \
  --name ffmpeg-watch-folder \
  -e DEBUG=0 \
  -e PRESETS="HD_TV_MP4 HD_TV" \
  -v /path/to/your/input:/ffwf-in \
  -v /path/to/your/output:/ffwf-out \
  [镜像名称]

注意：替换命令中的/path/to/your/input、/path/to/your/output为实际宿主机目录，[镜像名称]为该Docker镜像的具体名称。

输入目录结构要求

输入目录（{input directory}）必须包含以下两个子文件夹：

• _DONE：用于存放处理完成的源文件
• _OUT：用于临时存放编码过程中的输出文件

注意事项

• 输入目录必须严格遵循目录结构要求，否则可能导致处理失败
• 当前版本为测试版，不保证生产环境稳定性，建议仅用于测试与评估
• 编码预设列表可根据实际需求调整，多个预设需用空格分隔