coolasice1999/tmm-cli-cronjob

TinyMediaManager定时元数据更新镜像

镜像概述

本Docker镜像通过定时任务(cronjob)机制，在预设时间自动运行TinyMediaManager(TMM)命令行客户端，实现媒体元数据的定期更新。定时任务逻辑封装在entrypoint.sh脚本中，TMM实例的配置需通过TMM GUI版本完成。

核心功能与特性

• 命令行执行：提供TMM命令行客户端，支持非交互方式运行元数据更新任务
• 定时触发：内置cronjob定时任务，可在预设时间自动启动TMM元数据更新
• 元数据维护：支持电影、电视节目等媒体文件的元数据自动更新与同步
• 配置独立性：依赖TMM GUI版本完成初始配置，镜像专注于定时执行功能
• 脚本化控制：定时任务逻辑通过entrypoint.sh脚本实现，便于查看和调整

使用场景与适用范围

• 媒体服务器（如Plex、Emby、Jellyfin）的元数据定期维护
• 家庭影院系统中媒体库的无人值守式元数据更新
• 需要保持媒体元数据自动同步的个人或小型媒体服务
• 已通过TMM GUI完成媒体库配置的用户场景

使用方法与配置说明

前提条件

• 已通过TMM GUI版本完成媒体库配置（包括源路径、元数据提供商、命名规则等）
• 确保TMM配置文件可被Docker容器访问（建议通过卷挂载方式）

Docker运行示例

bash
docker run -d \
  --name tmm-cron \
  -v /本地/tmm配置目录:/config \  # 挂载TMM配置文件目录
  -v /本地媒体目录:/media \      # 挂载媒体文件存储目录
  --restart unless-stopped \
  [镜像名称]:[标签]

配置说明

1. 定时任务设置：默认定时执行时间通过entrypoint.sh中的cron表达式定义，标准cron格式为分 时 日 月 周（例如0 3 * * *表示每日凌晨3点执行）
2. 配置文件挂载：/config目录需包含TMM GUI生成的配置文件（主要为settings.xml），确保容器内路径与GUI配置中的媒体路径一致
3. 媒体目录挂载：媒体文件目录需与TMM GUI中配置的源路径对应，确保容器可访问媒体文件

调整定时任务时间

1. 进入运行中的容器：docker exec -it tmm-cron /bin/bash
2. 编辑定时任务脚本：vi /entrypoint.sh
3. 修改cron表达式（例如改为30 4 * * *表示每日4点30分执行）
4. 保存退出并重启容器：docker restart tmm-cron