leolitaly/emby-notifier-bot repository overview

⁠

⁠项目介绍：Emby Telegram 通知服务

• 项目名称：Emby Notifier x Telegram Bot
• 实时监控Emby媒体服务器的事件（播放、入库等），通过TG-BOT机器人发送格式化通知
• 支持复杂集数解析和时区自定义

⁠核心特性

• 全面支持事件监控：
  • 播放（开始/停止/暂停），
  • 媒体库更新（新增/删除/元数据刷新），
  • 用户登录/登出等事件。
• 通知中清晰展示智能集数解析：
  • 准确识别连续集（S01E01-E05），
  • 非连续散集（S01E08,E11-E14）及跨季集数。
• 用户信息追踪：播放事件中显示操作用户、设备及IP，方便多用户场景管理。
• 高可用性：自动重试失败通知，避免消息丢失，支持媒体封面图片发送。

⁠适用场景

• 家庭/团队共用Emby服务器，实时了解媒体更新和播放情况。
• 需要远程监控Emby活动（如新增剧集、用户登录）。
• 对通知格式有要求，希望清晰展示集数、评分、剧情等信息。

⁠Docker Compose 配置

• 创建 docker-compose.yml 文件，内容如下：

version: '3.8'

services:
  emby-notifier-bot:
    image: leolitaly/emby-notifier-bot:latest
    container_name: emby-notifier-bot
    network_mode: host
    environment:
      - TELEGRAM_BOT_TOKEN=your_token                    # tgbot_token
      - TELEGRAM_CHAT_ID=your_chat_id                    # tg_chat_id
      - EMBY_SERVER_URL=http://your_emby_server:8096     # emby地址
      - EMBY_API_KEY=your_api_key_here                   # emby_api
      - WEBHOOK_HOST=0.0.0.0
      - WEBHOOK_PORT=8099
      - EMBY_MONITOR_EVENTS=playback.start,playback.stop,playback.pause,user.authenticated,user.logout,library.new,library.deleted,metadata.update   # 无需修改
      - TZ=Europe/Rome            # 时区，默认Europe/Rome
      - ENABLE_COVERS=True          # 是否发送媒体封面图片
      - OVERVIEW_MAX_LENGTH=300     # 长文模式
    ports:
      - "8099:8099"
    restart: always

⁠使用说明

• 配置Emby Webhook
  • 让Emby将事件发送到通知服务：
    1. 登录Emby后台 → 「设置」→ 「通知」→ 「Webhook」→ 点击「+」添加Webhook。
    2. 配置Webhook：
    • 名称：任意（如 Telegram通知）。
    • URL：http://emby-notifier-bot的IP:8099/emby-webhook。
    • 事件类型：勾选需要监控的事件（建议全选）。
    • 格式：multipart/form-data。
    1. 点击「保存」，测试播放一个媒体或新增一个剧集，查看Telegram是否收到通知。

⁠环境变量详解

⁠常见问题排查

• 通知未收到：
  1. 检查 docker-compose logs 日志，确认是否有错误（如Token无效、网络不通）。
  2. 验证Emby Webhook配置的URL是否正确（可通过 curl http://emby-notifier-bot的IP:8099 测试连通性）。
• 代理无效：
  1. 检查代理地址格式是否正确（需包含 http:// 或 https://）。
  2. 日志中会显示 代理配置: 已启用，确认代理是否生效。

通过以上配置，即可实现Emby事件的实时Telegram通知，方便监控和管理媒体服务器。

⁠注意此版本不包含代理功能！！！

⁠Version: 2.0.0

⁠https://PeiFeng.li⁠

感谢原作者 https://hub.docker.com/u/nfhgw295⁠