vilsol/transcoder

Transcoder镜像说明

镜像概述

vilsol/transcoder是一个Docker容器，用于将挂载卷中的视频文件转码为H265格式，帮助用户优化存储占用并保持视频质量。支持自定义转码参数、***状态通知、忽略特定文件等实用功能。

核心功能

1. 批量将视频转码为H265格式，平衡存储与质量
2. 提供***实时通知，反馈转码进度与结果
3. 通过.transcodeignore文件忽略指定目录/文件
4. 可配置转码质量（CRF）、H265重转码规则等参数

使用场景

• 个人媒体库：统一视频格式，减少存储空间占用
• 家庭影院系统：为Kodi/Plex等平台准备兼容的H265视频
• 批量处理：自动转码大量视频文件到H265格式

配置说明

基础运行步骤

1. 修改挂载卷路径指向本地媒体文件夹
2. 执行docker-compose up -d启动容器

查看实时转码状态

bash
docker logs transcoder_transcoder_1 && docker attach --no-stdin transcoder_transcoder_1

（按CTRL-C可安全退出）

***通知配置

1. 创建.env文件
2. 设置BOT_KEY（机器人密钥）和CHAT_ID（接收聊天ID）
3. 重新创建容器生效

忽略文件设置

在媒体目录中创建.transcodeignore文件，列出需忽略的目录或文件，容器将跳过这些内容的转码。

H265重转码规则

默认允许重转码H265文件，可通过H265_TRANSCODE=False关闭。H265_MB_H定义最小MB/小时阈值，低于该值的文件不会被重转码。

环境变量列表

Docker Compose示例

yaml
version: '3'
services:
  transcoder:
    image: vilsol/transcoder
    volumes:
      - /your/local/media:/media  # 替换为本地媒体路径
    environment:
      - CRF=16
      - H265_TRANSCODE=True
      # 可选：添加***通知（需替换为实际值）
      # - BOT_KEY=your_bot_key
      # - CHAT_ID=your_chat_id