1. 为什么我们需要手动刮削?
作为一个影音爱好者,我最初搭建Jellyfin影音库时也遇到了自动刮削的各种问题。明明文件名已经很规范了,但就是有一大半电影无法识别;电视剧更是灾难,经常把不同季的内容混在一起。后来我发现,自动刮削失败率高主要有以下几个原因:
首先是网络环境问题。很多刮削源网站在国内访问不稳定,即使能ping通,实际刮削时也可能超时。其次是命名规范问题,自动刮削对文件名格式要求非常严格,但我们的本地资源往往来自不同渠道,命名五花八门。最后是元数据匹配算法的问题,自动刮削很难处理一些特殊情况的影视资源。
经过多次尝试,我发现tinyMediaManager(tmm)这个神器可以完美解决这些问题。它不仅能手动匹配元数据,还能让我们对匹配结果进行精细调整。最重要的是,通过合理配置,可以实现接近100%的刮削成功率。下面我就详细分享这套经过实战检验的完整方案。
2. 前期准备工作
2.1 网络环境配置
要让tmm正常工作,首先需要确保能稳定访问themoviedb.org这个最重要的元数据源。我测试过很多方法,最有效的是修改Hosts文件:
- 打开命令提示符,输入
ping api.themoviedb.org测试连通性 - 如果无法ping通,找到
C:\Windows\System32\drivers\etc\hosts文件 - 用记事本以管理员身份打开,添加以下内容并保存:
13.224.161.90 api.themoviedb.org 13.224.161.90 www.themoviedb.org- 重新ping测试,确认能够连通
这个IP地址是我长期使用最稳定的,如果以后失效,可以在线搜索最新的可用IP。
2.2 申请API密钥
themoviedb的API密钥是tmm工作的必备条件。申请过程其实很简单:
- 访问themoviedb官网注册账号并验证邮箱
- 进入API申请页面填写开发者信息
- 关键点:应用简介要写详细些(至少200字),姓名要填两个字符以上
- 提交后立即就能获得API密钥,记得妥善保存
2.3 软件下载与安装
这里有个重要提醒:一定要下载tmm v3版本!v4版本有严格的API调用限制,基本无法正常使用。下载后解压即可运行,无需安装。首次启动时会要求选择语言和设置媒体库,这些都可以稍后再配置。
3. tinyMediaManager详细使用指南
3.1 基础设置
首次使用tmm需要进行一些必要配置:
- 进入设置→刮削器,选择themoviedb.org作为主要数据源
- 粘贴之前申请的API密钥
- 建议勾选"自动下载最佳图像"和"自动重命名文件"
- 设置NFO文件格式为Jellyfin兼容模式
这些设置完成后,tmm就具备了基本的刮削能力。但要想获得最佳效果,还需要掌握更多技巧。
3.2 电影资源刮削实战
对于电影资源,我总结了一套高效的工作流程:
- 为每部电影创建单独文件夹,建议使用"电影名 (年份)"的格式
- 将电影文件放入对应文件夹,建议命名为"电影名 (年份).扩展名"
- 在tmm中导入整个电影库目录
- 右键点击电影→"搜索并刮削所选电影"
- 从搜索结果中选择最匹配的条目
- 检查并补充缺失的信息(如分级、简介等)
- 最后一定要点击"更新NFO文件"保存元数据
如果遇到无法自动匹配的电影,可以手动输入IMDb编号或直接编辑元数据。tmm还允许自定义海报和背景图,只需将图片放入电影文件夹即可自动识别。
3.3 电视剧资源处理技巧
电视剧的刮削比电影复杂得多,主要难点在于季和集的识别:
- 为每部剧创建单独文件夹,命名格式为"剧名 (年份)"
- 在剧集文件夹内创建Season子文件夹(如Season 1)
- 集数文件命名必须包含SXXEXX格式(如S01E01)
- 导入tmm后,先刮削整部剧的信息
- 检查每季的元数据是否完整,特别是季海报
- 对于无法自动匹配的集数,可以手动指定集编号
- 最后更新NFO文件时,要分别更新剧集和季的NFO
我强烈建议对电视剧采用单集刮削模式,虽然工作量稍大,但准确率最高。遇到特殊剧集(如特别篇)时,可以手动调整集编号来保持正确的播放顺序。
4. Jellyfin集成与优化
4.1 媒体库配置要点
在Jellyfin中配置媒体库时,有几个关键设置需要注意:
- 内容类型要正确选择(电影/电视剧)
- 添加文件夹时要选择包含NFO文件的父目录
- 元数据下载器建议全部取消选择
- 必须勾选"从NFO文件中读取元数据"
- 建议勾选"将图像保存到媒体文件夹中"
这样的配置可以确保Jellyfin完全依赖tmm生成的元数据,避免自动刮削带来的各种问题。
4.2 常见问题排查
在实际使用中可能会遇到一些问题,这里分享几个常见情况的解决方法:
- 封面不显示:检查图片是否保存在媒体文件夹,格式是否为jpg/png
- 季信息混乱:确认季文件夹命名规范,并在tmm中检查季编号
- 集顺序错误:在tmm中手动调整集编号,确保SXXEXX格式正确
- 元数据不更新:在Jellyfin中手动刷新元数据或重建库
4.3 高级技巧分享
经过长期使用,我总结出几个提升体验的技巧:
- 对于合集类电影(如漫威宇宙),可以在tmm中设置合集信息
- 使用tmm的重命名功能统一文件命名,保持库的整洁
- 定期备份NFO文件,防止意外丢失
- 对于动画剧集,可以在tmm中设置动画类型以获得更准确的元数据
这套方案虽然需要一些手动操作,但实际使用下来,刮削成功率接近100%,远高于自动刮削。特别是对于命名不规范或比较冷门的影视资源,手动刮削几乎是唯一可靠的解决方案。