gsariev/overr-syncerr

Overr-Syncerr 镜像文档

镜像概述

Overr-Syncerr是一款用于自动化管理媒体库字幕同步问题的工具，通过监听Overseerr的Webhook和问题报告功能触发字幕同步流程。该工具无缝集成Sonarr、Radarr媒体管理工具及Bazarr字幕管理服务，实现从媒体信息获取到字幕同步的全自动化处理，有效解决媒体库中字幕不同步问题。

核心功能与特性

• Sonarr和Radarr完整集成：可直接从Sonarr和Radarr获取剧集及电影的详细信息
• Bazarr深度集成：支持通过Bazarr同步字幕，包含4K媒体和HI（Hearing Impaired）字幕的特殊处理
• 智能语言映射：基于Webhook消息中的关键词自动映射至对应语言名称
• 音频轨道同步：默认使用第一个音频轨道作为字幕同步基准

适用场景

适用于搭建个人媒体服务器（如Plex、Emby用户）且需要自动化字幕管理的场景。特别适合已部署Overseerr（媒体请求系统）、Sonarr（剧集管理）、Radarr（电影管理）和Bazarr（字幕管理）的用户，通过Overseerr的问题反馈自动触发字幕同步流程，减少手动操作。

使用方法

Docker Compose部署

以下是使用Docker Compose部署的完整配置示例：

yaml
services:
  overr-syncerr:
    image: gsariev/overr-syncerr:latest
    container_name: overr-syncerr
    ports:
      - "8089:8089"  # 服务监听端口
    environment:
      # 基础服务配置
      BAZARR_API_KEY: "YOUR_BAZARR_API_KEY"          # Bazarr的API密钥
      BAZARR_URL: "http://BAZARR_IP:BAZARR_PORT/api"  # Bazarr API地址
      
      RADARR_API_KEY: "YOUR_RADARR_API_KEY"          # Radarr的API密钥
      RADARR_URL: "http://RADARR_IP:RADARR_PORT/api/v3"  # Radarr API地址
      
      SONARR_API_KEY: "YOUR_SONARR_API_KEY"          # Sonarr的API密钥
      SONARR_URL: "http://SONARR_IP:SONARR_PORT/api/v3"  # Sonarr API地址
      
      # 4K媒体服务配置（如使用独立的4K实例）
      BAZARR_4K_API_KEY: "YOUR_BAZARR_4K_API_KEY"    # 4K Bazarr的API密钥（可选）
      BAZARR_4K_URL: "http://BAZARR_4K_IP:BAZARR_4K_PORT/api"  # 4K Bazarr API地址（可选）
      
      RADARR_4K_API_KEY: "YOUR_RADARR_4K_API_KEY"    # 4K Radarr的API密钥（可选）
      RADARR_4K_URL: "http://RADARR_4K_IP:RADARR_4K_PORT/api/v3"  # 4K Radarr API地址（可选）
      
      SONARR_4K_API_KEY: "YOUR_SONARR_4K_API_KEY"    # 4K Sonarr的API密钥（可选）
      SONARR_4K_URL: "http://SONARR_4K_IP:SONARR_4K_PORT/api/v3"  # 4K Sonarr API地址（可选）

      # Overseerr配置
      OVERSEERR_API_KEY: "YOUR_OVERSEERR_API"        # Overseerr的API密钥
      OVERSEERR_URL: "http://YOUR_OVERSEERR_URL:OVERSEERR_PORT/api/v1"  # Overseerr API地址
      
      # Plex配置（可选）
      PLEX_TOKEN: "YOUR_PLEX_TOKEN"                  # Plex服务器令牌
      PLEX_HOST: "http://YOUR_PLEX_SERVER_URL:PLEX_SERVER_PORT"  # Plex服务器地址
      
      # 服务配置
      PORT: 8089  # 容器内部监听端口（需与端口映射保持一致）
      
      # 语言映射配置（JSON格式）
      LANGUAGE_MAP: '{"da":"Danish",
      "en":"English",
      "bg":"Bulgarian",
      "dansk":"Danish",
      "english":"English",
      "danske":"Danish",
      "eng":"English"}'
      
      # 同步关键词配置（JSON数组格式）
      SYNC_KEYWORDS: '["sync", "out of sync", "messed up", "synchronization"]'  # 用于识别字幕同步请求的关键词
      
    restart: unless-stopped  # 容器重启策略

环境变量详解

配置要点

1. 服务地址配置：确保所有服务（Bazarr/Radarr/Sonarr/Overseerr）的IP和端口可从容器内访问，建议使用Docker网络别名或局域网IP
2. 关键词配置：SYNC_KEYWORDS需包含用户在Overseerr问题报告中可能使用的字幕同步相关关键词
3. 语言映射：LANGUAGE_MAP需根据用户常用语言关键词配置，确保Webhook消息中的语言描述能正确映射

启动说明

配置完成后，通过以下命令启动服务：

bash
docker-compose up -d

服务将在8089端口监听Overseerr发送的Webhook请求，当检测到包含SYNC_KEYWORDS的问题报告时，自动触发字幕同步流程。