zggis/plex-tvtime

Plex-TVTime

概述

Plex-TVTime是一个Plex Webhook处理器，能够自动更新TVTime观看历史。当您在Plex上完成观看电视剧集后，该工具会自动将剧集标记为已看状态。

核心功能与特性

• 自动同步Plex电视剧观看记录至TVTime
• 仅处理Plex中"电视剧"类型的媒体库，忽略电影等其他类型
• 支持配置包含/排除特定剧集，限制同步范围
• 自动添加未在TVTime中存在的剧集到用户档案
• 不会将已标记为已看的剧集重复标记为"重看"，也不会更新首次标记时间

安装方法

Unraid

在Unraid上安装Plex-TVTime，可通过社区应用商店直接安装Docker容器。

Docker Desktop

本地通过Docker运行Plex-TVTime，使用以下命令。替换CONFIG为您希望保存数据库和日志文件的目录：

bash
$ docker run -e TVTIME_USER={您的TVTime用户名} -e TVTIME_PASSWORD={您的TVTime密码} -e PLEX_USERS={要关联的Plex用户名} -p 8080:8080 zggis/plex-tvtime:latest

使用说明

在浏览器中访问首页 http://[主机]:[端口]，将显示可在Plex中配置的Webhook URL。该URL格式为 http://[主机]:[端口]/webhook/plex，需在Plex > 设置 > Webhooks中添加此URL。

• Plex-TVTime会根据Plex中配置的"视频播放阈值"（可在Plex设置 > 媒体库中调整百分比）来判断是否标记剧集为已看。注意：Plex不会在手动标记剧集为已看时发送Webhook。
• 仅"电视剧"类型的媒体库会被Plex-TVTime处理，电影等其他类型的媒体库生成的Webhook将被忽略。
• 观看未添加到TVTime档案的剧集时，系统会自动将该剧集添加到TVTime。如不希望此行为，可通过下方的包含/排除配置参数限制同步的剧集范围。
• Plex-TVTime不支持关联多个TVTime账户。若服务器有多个用户且各有独立TVTime账户，建议为每个用户运行单独的Plex-TVTime实例，并分别配置Webhook和TVTime凭证。

配置说明

必填环境变量

可选环境变量

故障排除

若遇到问题，请先检查日志。根据配置的不同，日志可能输出到控制台或指定目录。如需进一步帮助，请提交https://github.com/Zggis/plex-tvtime/issues/new%EF%BC%8C%E5%B9%B6%E5%B0%86LOGGING_LEVEL%E8%AE%BE%E4%B8%BATRACE%EF%BC%8C%E9%99%84%E4%B8%8A%E7%9B%B8%E5%85%B3%E6%97%A5%E5%BF%97%E5%86%85%E5%AE%B9%EF%BC%88%E5%BA%94%E7%94%A8%E6%9C%AC%E8%BA%AB%E4%B8%8D%E7%94%9F%E6%88%90%E6%97%A5%E5%BF%97%E6%96%87%E4%BB%B6%EF%BC%8C%E5%8F%AF%E7%9B%B4%E6%8E%A5%E5%A4%8D%E5%88%B6%E6%8E%A7%E5%88%B6%E5%8F%B0%E6%97%A5%E5%BF%97%EF%BC%89%E3%80%82

FAQ

问题：是否支持电影？

回答：我曾尝试支持电影功能，因为TVTime移动应用支持追踪电影，但TVTime网站似乎不支持。由于TVTime未提供公开API，我只能通过网页抓取实现功能，因此无法整合电影同步。