基于Python与Watchdog的Emby媒体库自动化监控与信息推送实践

1. 为什么你需要一个媒体库“小管家”？

如果你和我一样，是个影音爱好者，家里搭建了Emby Server来管理自己收藏的电影和剧集，那你肯定遇到过这样的场景：辛辛苦苦下载了一部新电影，把它丢进媒体库对应的文件夹，然后……就忘了。直到某天想找部片子看，才发现“咦，我什么时候存了这部《奥本海默》？” 或者，朋友来家里做客，想秀一下你的私人影院，结果翻来翻去，自己都搞不清最近新增了什么内容。

Emby Server本身已经很棒了，它能自动刮削影片信息，生成漂亮的海报墙。但它的“通知”功能，更多是面向服务器内部的。我们作为库的管理员和主要用户，反而缺少一个轻量、及时、能送到手边的“入库提醒”。想象一下，每次有新的影视资源入库，你的手机就能收到一条精美的消息卡片，上面有影片海报、评分、简介，甚至还有观看链接，是不是瞬间就觉得这个媒体库“活”了起来？

这就是我们今天要动手实现的东西：一个用Python写的小工具，它像一位不知疲倦的“小管家”，24小时盯着你的Emby媒体库文件夹。一旦发现有新的.nfo文件（Emby刮削后生成的信息文件）出现，它就会立刻行动起来，去网上（TMDB）抓取更丰富的资料，然后通过Telegram Bot，把一条结构化的信息推送到你的手机或者一个订阅频道里。整个过程完全自动化，无需你手动干预。实现这个功能，核心只需要两个Python库：Watchdog和Requests，再加上一点逻辑编排。我实测下来非常稳定，已经平稳运行了大半年，成了我管理媒体库不可或缺的助手。接下来，我就带你从零开始，一步步搭建这个属于你自己的自动化监控推送系统。

2. 动手前的准备工作：环境与工具

在开始写代码之前，我们需要把“厨房”收拾好，把必要的“食材”和“厨具”备齐。整个过程不复杂，但每一步都很关键。

2.1 核心武器：Python与必备库

首先，确保你的系统里安装了Python。我强烈建议使用Python 3.10或更高版本，因为我们在后续代码中会用到match...case语句，这个语法在3.10才被正式引入，能让我们的代码更清晰。你可以打开终端，输入python3 --version来检查。

接下来，我们需要通过pip安装两个核心的Python库：

• Watchdog：这是我们监控文件系统的“眼睛”。它能够高效、实时地监听指定目录下的文件创建、修改、删除等事件，并且跨平台支持很好。
• Requests：这是我们与外界API通信的“手”。用它来调用TMDB的API获取影片数据，以及调用Telegram Bot的API发送消息，非常方便。

安装命令很简单，一行搞定：

pip3 install watchdog requests

如果提示权限问题，可以加上--user参数安装到用户目录，或者根据你的系统使用sudo。

2.2 获取三把“钥匙”：API Token与路径

我们的工具需要和三个外部服务打交道，因此需要准备好对应的凭证和路径。

第一把钥匙：Telegram Bot Token

1. 在Telegram里找到@BotFather这个官方机器人。
2. 发送/newbot指令，按照提示给你的机器人起名字、设用户名（必须以bot结尾）。
3. 创建成功后，BotFather会发给你一串像1102015433:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw这样的哈希字符串，这就是你的BOT_TOKEN，务必保存好。

第二把钥匙：Telegram频道/群组 Chat ID

1. 创建一个Telegram频道（Channel）或群组（Group）。
2. 将你刚才创建的Bot添加为管理员（对于频道）或成员（对于群组）。
3. 在浏览器中访问这个URL（将<你的BOT_TOKEN>替换掉）：https://api.telegram.org/bot<你的BOT_TOKEN>/getUpdates
4. 在你的频道或群组里随便发一条消息。
5. 刷新刚才的浏览器页面，你会看到一串JSON数据。在里面找到"chat":{"id":-1001234567890}这样的字段，那个负数（或正数）id就是你的CHAT_ID。

第三把钥匙：TMDB API Key

1. 访问TMDB官网并注册账号。
2. 进入个人设置页面，找到“API”选项，申请一个API密钥（类型选“Developer”即可）。
3. 通过邮件验证后，你就能在API页面看到你的API Key（即TMDB_API）。

最后一项：你的媒体库路径 这就是你Emby Server媒体库在硬盘上的实际路径。例如，在Linux上可能是/media/movies，在Windows上可能是D:\Emby\Movies。我们的监控程序就需要指向这个路径。

3. 构建监控核心：用Watchdog抓住文件变动

有了基础环境，我们来打造这个系统最核心的“感知”部分——文件监控。Watchdog库让这件事变得异常简单。

3.1 理解Watchdog的事件模型

Watchdog的工作原理是“事件驱动”。它不需要你写循环去不停地扫描文件夹，那样效率太低。相反，它会在后台默默监听系统发出的文件系统事件。当有文件被创建、修改、移动或删除时，系统会发出一个通知，Watchdog捕获到这个通知后，就会触发我们预先定义好的“事件处理器”函数。

对于我们这个场景，我们只关心一种事件：新文件的创建。因为当Emby Server刮削一部新入库的影片时，它会在影片文件旁边生成一个同名的.nfo文件（例如The.Matrix.1999.nfo）。这个.nfo文件是一个XML格式的信息文件，包含了TMDB或IMDb的ID、片名、简介等基础信息。监控到这个文件的创建，就等于知道了有新影片入库。

3.2 编写事件处理器类

我们来写一个Python类，继承Watchdog提供的FileSystemEventHandler类，并重写我们感兴趣的方法。

import time
from watchdog.events import FileSystemEventHandler

class NfoFileHandler(FileSystemEventHandler):
    """自定义事件处理器，专门处理.nfo文件的创建事件"""

    def on_created(self, event):
        """