xanderstrike/plex2ifttt

plex2ifttt

镜像概述和主要用途

plex2ifttt 镜像可将 Plex webhook 转换为 IFTTT webhook 事件，实现基于 Plex 媒体播放状态的智能家居联动。典型应用场景包括：家庭影院播放媒体时自动调暗灯光，暂停或结束播放时恢复灯光亮度。

核心功能和特性

支持的事件类型

• plex_play：播放事件（包括播放、恢复、标记已观看操作）
• plex_play_day：日间播放事件（当前硬编码为美国太平洋时间）
• plex_pause：暂停或停止事件（包括暂停、停止、播放完成操作）

过滤功能

• 支持按用户名过滤：仅处理指定用户的 Plex 操作
• 支持按播放器 UUID 过滤：仅处理指定设备的 Plex 操作
• 多值支持：用户名和播放器 UUID 可通过逗号分隔指定多个

使用场景和适用范围

• 家庭媒体中心与智能家居设备联动（灯光、窗帘、音响等）
• 基于 Plex 播放状态的自动化场景配置
• 需要区分不同用户/设备的 Plex 事件处理场景

使用方法和配置说明

前提条件

1. 拥有 IFTTT 账户并获取 webhook 密钥
2. 知道 Plex 用户名和目标播放器 UUID（未知时可通过应用日志获取）
3. 确保 Plex 服务器可访问 plex2ifttt 服务（同一机器、局域网或公网访问）

获取 IFTTT 密钥

1. 访问 [***]
2. 点击 "Documentation" 即可查看并复制你的 IFTTT 密钥

Docker 部署示例

基本部署命令

bash
docker run \
  -e USER_ID=<username1>,<username2> \
  -e PLAYER_UUID=<uuid1>,<uuid2> \
  -e IFTTT_KEY=<your-ifttt-key> \
  --name plex2ifttt \
  -p 8080:8080 \
  xanderstrike/plex2ifttt

参数说明

• -e USER_ID：允许触发事件的 Plex 用户名（多个用逗号分隔）
• -e PLAYER_UUID：允许触发事件的 Plex 播放器 UUID（多个用逗号分隔）
• -e IFTTT_KEY：IFTTT webhook 密钥
• -p 8080:8080：端口映射（容器内端口 8080，可根据需要修改主机端口）
• --name plex2ifttt：容器名称

Plex 配置

1. 登录 Plex 服务器管理界面
2. 进入 设置 > Webhooks
3. 添加 webhook URL：http://<plex2ifttt-ip>:8080/hook（替换为实际服务地址）

IFTTT 规则配置

1. 登录 IFTTT 并创建新 Applet
2. 选择触发器：Webhooks > 接收 web 请求
3. 输入事件名称（需为 plex_play、plex_play_day 或 plex_pause 之一）
4. 选择动作服务（如智能灯光、通知等）并配置具体操作

注意事项

• 播放器 UUID 未知时，启动容器后可通过日志查看所有未知播放器 ID
• 服务需保持运行状态以接收 Plex webhook
• 确保网络通畅，Plex 服务器能正常访问 plex2ifttt 服务的 /hook 端点