journeyover/plex-auto-languages

Plex Auto Languages

Plex Auto Languages 通过自动根据用户偏好更新电视剧的音轨和字幕设置，增强您的Plex体验。类似Netflix，它会记住每部电视剧的语言设置，且不会干扰全局设置或其他用户的偏好。

目录

• Plex Auto Languages
  • 目录
  • 功能特性
  • 快速开始
    • 要求
    • 安装选项
      • Docker安装
      • Python安装
  • 配置
    • 关键参数
      • Plex配置
      • 更新设置
      • 通知（可选）
      • 高级选项
    • 环境变量摘要
  • 许可证

功能特性

• 无缝语言选择： 想观看韩语原版《鱿鱼游戏》并搭配英文字幕？只需为第一集设置一次，即可轻松享受后续所有剧集。👌

• 每部剧自定义： 希望《曼达洛人》使用英语原声，而《权力的游戏》使用法语配音？每部剧的偏好会被独立记录。✔️

• 多用户支持： 完美适用于偏好多样的家庭。每位用户的音轨和字幕设置会被自动且独立地选择。✔️

快速开始

要求

使用Plex Auto Languages需满足：

1. Plex令牌： 如何获取令牌，请参考Plex官方指南。

2. Python 3.8+ 或 Docker： 应用可通过Python原生运行或作为Docker容器运行。

安装选项

Docker安装

推荐使用Docker运行Plex Auto Languages。

Docker镜像标签：

• main（开发版）： 跟踪main分支的最新提交，包含最新功能，但可能不稳定。

  推荐用于：开发者和测试人员。

  注意：每次提交都会更新，可能包含破坏性变更。

• latest（稳定版）： 指向最新稳定版本，适合生产环境。

  推荐用于：一般用户。

• A.B.C.D（版本化发布）： 特定版本标签，确保一致性和可靠性。

  推荐用于：需要严格版本控制的环境。

Docker仓库：

可从以下任一仓库拉取Docker镜像：

• ghcr.io/journeydocker/plex-auto-languages:<标签名>
• journeyover/plex-auto-languages:<标签名>

Docker Compose配置：

以下是最小化的docker-compose.yml配置示例：

yaml
services:
  plexautolanguages:
    image: journeyover/plex-auto-languages:main
    environment:
      - PLEX_URL=http://plex:32400
      - PLEX_TOKEN=我的PLEX令牌
      - TZ=Europe/Paris
    volumes:
      - ./config:/config

使用Docker CLI运行：

也可直接运行容器：

bash
docker run -d \
  -e PLEX_URL=http://plex:32400 \
  -e PLEX_TOKEN=我的PLEX令牌 \
  -e TZ=Europe/Paris \
  -v ./config:/config \
  journeyover/plex-auto-languages:main

Python安装

按照以下步骤进行Python原生安装：

1. 克隆仓库：

   bash
   git clone git@github.com:JourneyDocker/Plex-Auto-Languages.git
   

2. 安装依赖：

   bash
   cd Plex-Auto-Languages
   python3 -m pip install -r requirements.txt
   

3. 创建配置文件：

   使用https://github.com/JourneyDocker/Plex-Auto-Languages/blob/main/config.example.yaml%E6%A8%A1%E6%9D%BF%E5%88%9B%E5%BB%BA%E8%87%AA%E5%B7%B1%E7%9A%84%60config.yaml%60%E3%80%82%E4%BB%85%E9%9C%80%E9%85%8D%E7%BD%AE%60plex.url%60%E5%92%8C%60plex.token%60%E3%80%82

4. 运行应用：

   bash
   python3 main.py -c ./config.yaml
   

配置

应用可通过以下方式配置：

• 环境变量
• YAML文件（挂载至/config/config.yaml；示例配置见https://github.com/JourneyDocker/Plex-Auto-Languages/blob/main/config.example.yaml%EF%BC%89

关键参数

Plex配置

yaml
plex:
  url: "http://plex:32400"  # 必需：Plex服务器URL
  token: "我的PLEX令牌"    # 必需：Plex令牌

更新设置

yaml
plexautolanguages:
  update_level: "show"          # 选项："show"（默认）、"season"
  update_strategy: "all"        # 选项："all"、"next"（默认）
  trigger_on_play: true         # 播放剧集时更新语言设置
  trigger_on_scan: true         # 扫描新文件时更新语言设置
  trigger_on_activity: false    # 浏览Plex时更新语言设置（实验性）
  refresh_library_on_scan: true # Plex扫描时刷新缓存的媒体库
  ignore_labels:                # 忽略带有这些Plex标签的剧集
    - PAL_IGNORE
  ignore_libraries:             # 更新音轨/字幕时忽略这些媒体库
    - ""

通知（可选）

使用https://github.com/caronc/apprise%E9%85%8D%E7%BD%AE%E9%80%9A%E7%9F%A5%EF%BC%9A

yaml
notifications:
  enable: true
  apprise_configs:
    - "discord://webhook_id/webhook_token"

高级选项

yaml
scheduler:
  enable: true
  schedule_time: "04:30"
data_path: ""  # 系统/缓存文件路径
debug: false   # 启用调试日志

环境变量摘要

[!NOTE] Plex令牌也可通过Docker secret提供，此时需在环境变量PLEX_TOKEN_FILE中指定secret的文件路径，默认路径为/run/secrets/plex_token。

[!NOTE] 环境变量NOTIFICATIONS_APPRISE_CONFIGS应设为表示通知配置数组的JSON字符串。每个配置可包含urls、users和events。例如：

json
[
  {"urls": ["discord://webhook_id/webhook_token"]},
  {"urls": ["gotify://hostname/token"], "users": ["MyUser1", "MyUser2"]},
  {"urls": ["tgram://bottoken/ChatID"], "users": ["MyUser3"], "events": ["play_or_activity"]}
]

许可证

本项目采用 MIT 许可证 授权。