parkerhemphill/media-converter

parkerhemphill/media-converter

镜像概述

parkerhemphill/media-converter是一个简单的Docker镜像，集成FFMPEG、media-info和HandBrakeCLI工具，用于将下载的媒体文件转换为MP4格式。该镜像通过自动化流程处理媒体文件，支持主流编码格式，适用于家庭媒体服务器（如Plex、Jellyfin、Kodi）的媒体库管理。

当前版本：2.1.3（更新于2020年3月6日）
更新说明：

• 2.1.3版本新增ARM架构支持
• 2.0.0版本开始通过Dockerfile从源码编译最新版HandBrake和FFMPEG，确保镜像始终包含最新工具版本
• 使用GitHub Actions每周日UTC午夜自动重建，更新依赖库

核心功能与特性

• 多工具集成：整合FFMPEG、media-info和HandBrakeCLI，提供完整的媒体处理能力
• 自动化流程：通过无限循环（每30秒检查一次）自动检测、移动和转换媒体文件
• 智能编码：media-info分析文件属性（分辨率、比特率等），HandBrakeCLI根据分析结果应用优化转换设置
• 编码选择：支持x264（默认）和x265（HVEC）两种编码格式
• 跨架构支持：兼容x86和ARM架构
• 通知功能：支持macOS Growl通知（需配置环境变量）
• 日志记录：转换历史记录保存在<volume>/Logs/converted.log
• 权限管理：可通过PUID/PGID指定运行用户，默认使用1000/1000
• 目录自动创建：启动时检查并创建所需目录结构

使用场景

• 家庭媒体服务器管理员，需要将下载的MKV等格式媒体统一转换为MP4
• 配合SickChill、Deluge等下载工具，实现媒体文件的自动处理与导入
• Plex/Jellyfin/Kodi用户，优化媒体文件格式以提升播放兼容性

操作流程

1. 文件放置：下载客户端将完成的媒体文件保存至 <volume>/Complete/<TVShows|Movies> 目录
2. 文件移动：容器每30秒检查一次，将上述目录文件移动至 <volume>/Complete/Convert/<TVShows|Movies>
3. 媒体转换：
   • 若文件为MKV格式，FFMPEG先将其转换为临时MP4并删除原MKV
   • media-info分析文件属性（分辨率、比特率等），确定最佳转换参数
   • HandBrakeCLI使用优化参数转换文件，输出为 <filename>-converted.mp4（注：若转换中断，重启后会删除不完整的转换文件）
4. 文件导入：转换完成后，文件被移动至 <volume>/Complete/IMPORT/<TVShows|Movies>，供媒体管理工具（如SickChill）导入到媒体库

目录结构说明

容器内部路径统一为 /media，外部路径需通过卷挂载映射：

环境变量配置

部署示例

Docker Compose配置

yaml
# docker-compose.yaml
version: "3"
services:
  media-converter:
    image: parkerhemphill/media-converter:latest
    container_name: media-converter
    network_mode: host
    environment:
      - PUID=1000                # 替换为实际用户ID（通过`id <用户名>`获取）
      - PGID=1000                # 替换为实际用户组ID
      - TZ=Asia/Shanghai         # 替换为实际时区
      - ENCODE=x264              # 编码格式，可选x264或x265
      - GROWL=YES                # 可选，启用Growl通知
      - GROWL_IP=192.168.1.100   # 可选，Growl目标IP
      - GROWL_PORT=23053         # 可选，Growl端口
    volumes:
      - /path/to/media:/media    # 替换为实际媒体目录
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pgrep -f '/bin/bash /opt/media-converter' >/dev/null || exit 1"]
      interval: 60s
      timeout: 5s
      retries: 5

Docker Run命令

基础版（无Growl通知）：

bash
docker run -d \
  --name=media-converter \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e ENCODE=x264 \
  -v /path/to/media:/media \
  --restart unless-stopped \
  parkerhemphill/media-converter:latest

带Growl通知版：

bash
docker run -d \
  --name=media-converter \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e ENCODE=x264 \
  -e GROWL=YES \
  -e GROWL_IP=192.168.1.100 \
  -e GROWL_PORT=23053 \
  -v /path/to/media:/media \
  --restart unless-stopped \
  parkerhemphill/media-converter:latest

支持与维护

容器管理命令

• 进入容器shell：
  docker exec -it media-converter /bin/bash

• 查看容器启动日志：
  docker exec -it media-converter cat /tmp/media-converter.log

• 查看转换历史日志：
  docker exec -it media-converter cat /media/Logs/converted.log

• 监控当前转换任务：
  docker exec -it media-converter status

• 查询容器版本：
  docker inspect -f '{{ index .Config.Labels "build_version" }}' media-converter

• 查询镜像版本：
  docker inspect -f '{{ index .Config.Labels "build_version" }}' parkerhemphill/media-converter