📺 一个为 Emby 服务器的管理员打造的全功能 Telegram Bot，支持媒体事件推送、系统事件告警、交互式搜索、播放状态监控、按需扫描媒体库、网盘文件管理、Emby用户管理、灵活切换系统工具，并具备自动消息删除功能。适用于家庭服务器、媒体分享群组等多种场景，支持 Docker 快速部署。
📄 详细使用说明参见： 👉 User-Guide.md
📄 完整配置文件参见： 👉 config/config.yaml
- 🔔 全方位事件推送：支持媒体事件（播放、新增、删除）、用户事件（登录成功/失败、用户创建/删除）和系统事件（服务器需重启）的实时通知，便于管理员全面掌握服务器动态。
- 🔄 精准的扫描与刷新控制：通过
/manage命令可按需触发扫描所有媒体库、扫描指定媒体库或扫描单个节目文件夹，以快速发现新增文件。同时，独立的元数据刷新功能可以强制为某个节目重新刮削信息，精确修正错误数据。 - 🗃️ 模块化远程管理：
/manage命令现已分为“节目与文件管理”和“用户管理”两大模块，支持远程扫描、刷新、更新、入库、删除媒体文件（视频文件以.strm方式）。 - 👤 完整的用户管理：通过
/manage命令可远程创建新用户（基于模板）、修改用户名/密码、删除用户，实现 Emby 用户全生命周期管理。 - 🌐 可插拔的系统工具：通过
/settings菜单，现在可以自由切换IP地理位置查询API（内置百度、IP138、IP-API.com等多种服务），以适应不同网络环境，获得最准确的查询结果。 - 🔍 智能交互式搜索：支持关键词分页展示，当直搜无果时会自动通过 TMDB 别名进行后备搜索，并可展示剧集各季码率、音轨、更新进度等。
- ✅ 播放状态监控与远程控制：通过
/status命令可实时查看播放状态，并可终止会话或群发消息。 - 🧩 权限控制：可设置机器人仅在指定群组响应，部分命令仅管理员可执行。
- ♻️ 自动消息撤回：播放通知、搜索响应等均可设置在 60 秒后自动删除，保持聊天清爽。
| 类别 | 功能说明 |
|---|---|
| 播放事件通知 | 支持播放开始、暂停、停止等事件自动推送，可展示播放进度、用户信息、设备、IP归属地等。 |
| 媒体库更新 | 新增/删除节目自动通知，可选展示封面、音视频及字幕规格、剧情简介、入库时间等。 |
| 系统与用户事件 | 支持用户登录成功/失败、用户创建/删除/更新、服务器需要重启等多种关键事件通知，便于管理员监控。 |
| 媒体文件管理 | /manage 支持扫描、刷新元数据、从网盘更新、添加入库、删除 Emby 条目与物理文件（可以精确处理到单/多集/季）。 |
| Emby 用户管理 | /manage 支持创建新用户（基于模板）、修改用户名/密码、删除指定用户。 |
| 播放状态控制 | /status 查看所有在线用户，支持发送消息、群发消息、远程终止单人/所有会话。 |
| 节目搜索 | /search 支持关键词与智能后备搜索，展示剧集更新进度、音视频及字幕规格、TMDB链接等。 |
| 内容配置 | 通过 content_settings 精细控制每类通知的展示内容，并可切换IP查询服务等系统工具。 |
| 通知管理 | 通过 notification_management 控制哪些事件启用通知，推送到哪类聊天。 |
| 自动撤回 | 可配置哪些类型通知在发送后定时撤回，避免消息冗余。 |
| 权限与安全 | 支持限制机器人只在特定群组响应命令，部分命令仅管理员可用。 |
| 命令 | 描述 | 权限要求 | 详细使用说明 |
|---|---|---|---|
/search |
搜索节目关键词，支持智能后备搜索，展示剧集更新状态与规格。 | 所有人 | 👉 /search.md |
/status |
查看当前播放会话，支持远程控制。 | 管理员 | 👉 /status.md |
/settings |
打开交互式菜单，配置通知内容、系统工具（如IP查询API）等。 | 管理员 | 👉 /settings.md |
/manage |
管理媒体文件与 Emby 用户，支持扫描、刷新、更新、入库、删除等高级操作。 | 管理员 | 👉 /manage.md |
- 新增节目通知
-
Emby 在线播放状态查看
-
搜索电视剧/电影
- Emby节目和文件管理
- 交互式设置菜单
MIT License
本项目仅供学习交流使用，禁止商业用途。
- 📦 GitHub: https://github.com/xpisce/emby-notifier
- 🐳 Docker Hub: https://hub.docker.com/r/xpisce/emby-notifier
欢迎 Star ⭐ / Fork 🍴，如有问题欢迎提 Issue 或 PR 🙌