tenasi/plexannouncer

Plex Announcer 镜像文档

镜像概述和主要用途

Plex Announcer是一个轻量级机器人Docker镜像，核心功能是监控Plex媒体服务器并通过 webhook将新添加的媒体内容更新推送至指定***频道，实现媒体库更新的实时通知。

核心功能和特性

• 实时检测Plex媒体服务器中新添加的媒体内容
• 通过*** webhook自动发送媒体更新通知
• 支持两种配置方式：环境变量或配置文件
• 简单部署，可与现有Plex环境快速集成

使用场景和适用范围

适用于所有Plex媒体服务器用户，尤其是需要在***社区、家庭群组或个人频道中实时获取媒体库更新信息的场景，如家庭媒体共享管理、媒体服务器管理员监控等。

详细使用方法和配置说明

前提条件

使用前需在服务器/频道设置中创建webhook并复制webhook URL。关于 webhook的创建方法，可参考***官方文档。

使用方式

通过环境变量配置

运行容器时指定以下环境变量：

• PLEX_SERVER_URL: Plex服务器访问URL（格式示例：https://app.plex.tv/desktop#!/server/SERVER_ID）
• PLEX_WEBHOOK_TOKEN: 随机生成的webhook验证令牌
• DISCORD_WEBHOOK_URL: ***频道webhook完整URL

示例命令：

bash
docker run -p 32500:32500 -e PLEX_SERVER_URL="https://app.plex.tv/desktop#!/server/SERVER_ID" -e PLEX_WEBHOOK_TOKEN="SOME_RANDOM_TOKEN" -e DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN" docker.xuanyuan.run/tenasi/plexannouncer:latest

通过配置文件配置

1. 创建JSON格式配置文件，包含以下参数：

   json
   {
       "plex_server_url": "https://app.plex.tv/desktop#!/server/SERVERID",
       "plex_webhook_token": "RANDOM_TOKEN",
       "discord_webhook_url": "https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN"
   }
   

2. 运行容器并挂载配置文件目录：

   bash
   docker run -v /path/to/config/dir:/config -p 32500:32500 docker.xuanyuan.run/tenasi/plexannouncer:latest
   

在Plex中注册Webhook

在Plex服务器的"设置 > Webhooks"页面中添加webhook，URL格式为：

http://IP:PORT/RANDOM_TOKEN

其中：

• IP为运行容器的主机IP地址
• PORT为容器映射端口（默认32500）
• RANDOM_TOKEN为配置的PLEX_WEBHOOK_TOKEN值

源代码

• https://github.com/tenasi/plexannouncer