plexinc/slack-music-notifications

Plex-Slack音乐通知应用

镜像概述

该应用通过Plex Webhook监听音乐播放状态，将播放/暂停等状态同步至Slack用户状态，支持自定义播放/暂停表情及状态保护，可通过Heroku、本地或Docker部署。

核心功能

• Slack状态同步：通过Plex Webhook将音乐播放状态实时同步至Slack用户状态
• 多部署方式：支持Heroku一键部署、本地运行及Docker容器化部署
• 自定义表情：可配置播放/暂停状态对应的Slack表情
• 状态保护：当Slack状态表情非指定播放/暂停表情时，阻止状态被覆盖

使用场景

• Plex用户希望在Slack中实时展示音乐播放状态
• 团队协作环境中分享当前播放的音乐状态
• 个人使用时通过Slack快速了解Plex音乐播放情况

准备工作

1. 获取Plexamp播放器标识符

在Plexamp的config.json中查找"user": "identifier"字段：

• Mac：~/Library/Application Support/Plexamp/config.json
• Windows：C:\Users\<username>\AppData\Local\Plexamp\Plexamp\config.json

2. 创建Slack Legacy Token

访问Slack Legacy Tokens页面创建令牌。

3. 启用PMS Webhooks

在Plex Media Server中启用Webhooks：
设置 → 服务器 → 网络（显示高级选项） → 勾选Webhooks

运行应用

方式1：Heroku一键部署

![Deploy]([***]

方式2：本地运行

1. 安装node.js（v10+，推荐使用https://github.com/nvm-sh/nvm%E7%AE%A1%E7%90%86%E7%89%88%E6%9C%AC%EF%BC%89
2. 安装yarn
3. 克隆代码仓库
4. 安装依赖：yarn
5. 启动应用：

bash
$ yarn start

应用将运行在 http://localhost:8000

方式3：Docker运行

bash
$ yarn docker:build  # 构建Docker镜像
$ yarn docker:start   # 启动Docker容器

应用将运行在 http://localhost:8000

配置Webhook

在Plex账户设置中添加指向应用运行地址的Webhook：

• Heroku部署：URL格式为 https://<my-heroku-app>.herokuapp.com
• 本地/Docker运行：URL为 http://localhost:8000（若部署在服务器，需替换为服务器IP/域名）

配置参数说明

可通过查询参数或环境变量配置应用，若同时提供，查询参数优先级更高。

完整配置示例

[***]{slack_token}&username={plex_username}&player={player_client_identifier}&playEmoji=plexamp-outline&pauseEmoji=plexamp-outline-desaturated