zyuzone/emby-notifier

•Updated 6 months ago

Image

915

zyuzone/emby-notifier repository overview

⁠Emby Telegram Notification Bot

📺 一个为 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` 控制哪些事件启用通知，推送到哪类聊天。
自动撤回	可配置哪些类型通知在发送后定时撤回，避免消息冗余。
权限与安全	支持限制机器人只在特定群组响应命令，部分命令仅管理员可用。

⁠🔧 命令说明（Telegram）

命令	描述	权限要求	详细使用说明
`/search`	搜索节目关键词，支持智能后备搜索，展示剧集更新状态与规格。	所有人	👉 /search.md⁠
`/status`	查看当前播放会话，支持远程控制。	管理员	👉 /status.md⁠
`/settings`	打开交互式菜单，配置通知内容、系统工具（如IP查询API）等。	管理员	👉 /settings.md⁠
`/manage`	管理媒体文件与 Emby 用户，支持扫描、刷新、更新、入库、删除等高级操作。	管理员	👉 /manage.md⁠