netplexflix/umtk

Docker镜像：Kometa Coming Soon 配置生成器

概述

该镜像用于生成Kometa媒体集合管理工具所需的"Coming Soon"（即将上映）集合及覆盖.yml配置文件，需与Radarr（电影管理）和Sonarr（电视剧管理）集成，通过获取这两个工具中的即将上映内容数据，自动生成符合Kometa规范的配置文件，辅助用户实现媒体集合的自动化管理。

核心功能

1. "Coming Soon"集合创建

自动根据Radarr和Sonarr中的即将上映内容数据，生成"Coming Soon"主题媒体集合，包含即将发布的电影和电视剧信息。

2. 覆盖.yml文件生成

产出Kometa所需的覆盖（overlay）配置文件，定义集合的显示样式、排序规则及元数据展示方式，无需手动编写配置。

3. Radarr/Sonarr集成

通过API接口与Radarr和Sonarr实时同步数据，确保"Coming Soon"集合内容准确反映最新的即将上映信息，包括发布日期、标题、海报等元数据。

使用场景

• Kometa用户：需自动管理媒体库中"即将上映"类内容集合的用户
• 媒体服务器管理员：希望通过自动化工具简化Kometa配置维护流程的管理员
• Radarr/Sonarr用户：已部署Radarr和Sonarr，需要将其即将上映数据同步至Kometa的用户

使用方法

前提条件

• 已部署Radarr和Sonarr服务，且API接口可访问
• 已安装Docker环境
• 获取Radarr和Sonarr的API密钥（在对应工具的设置-常规中获取）

基础部署命令

bash
docker run -d \
  --name kometa-coming-soon \
  -e RADARR_URL="http://your-radarr-ip:7878" \
  -e RADARR_API_KEY="your-radarr-api-key" \
  -e SONARR_URL="http://your-sonarr-ip:8989" \
  -e SONARR_API_KEY="your-sonarr-api-key" \
  -v /path/to/kometa/config/overlays:/output \
  [镜像名称]

配置参数说明

与Kometa集成步骤

1. 挂载输出目录：将容器的/output目录（或自定义的OUTPUT_PATH）挂载到Kometa的覆盖配置目录（通常为kometa/config/overlays）

2. 配置Kometa：在Kometa的主配置文件（如config.yml）中添加对生成文件的引用：

   yaml
   collections:
     - file: overlays/coming_soon_overlay.yml
   

3. 重启Kometa：重启Kometa服务使配置生效，此时"Coming Soon"集合将显示在媒体库中

注意事项

• 确保Radarr和Sonarr服务处于运行状态，且API地址和密钥正确
• 输出目录需赋予容器读写权限（可通过-v挂载宿主机目录并设置权限）
• 如需实时更新数据，可通过SYNC_INTERVAL参数调整同步频率（单位：分钟）
• 生成的.yml文件可手动编辑调整细节，再次运行容器将覆盖原有文件（建议先备份自定义修改）