别再让Jellyfin自动刮削折磨你了!用tinyMediaManager v3手动整理群晖影音库(附Hosts修改与API申请避坑)
2026/5/26 11:43:28 网站建设 项目流程

群晖NAS影音库终极整理方案:tinyMediaManager v3精准刮削实战指南

你是否经历过这样的崩溃时刻?——精心收集的数千部影视作品导入Jellyfin后,自动刮削结果惨不忍睹:经典电影被识别成B级片,热门剧集封面变成毫不相关的海报,甚至30%的内容直接"消失"在系统中。更令人抓狂的是,你永远不知道问题出在文件名格式、网络环境还是元数据源本身。本文将彻底改变这种局面,通过tinyMediaManager v3(以下简称tmm)实现像素级精准控制的手动刮削方案,让你的影音库从此告别混乱。

1. 为什么自动刮削总让你失望?

自动刮削看似美好实则充满陷阱。主流媒体服务器依赖的TMDB、TVDB等开放数据库存在几个致命缺陷:首先,命名容错率极低,即使文件名只差一个标点也可能匹配失败;其次,数据覆盖不完整,特别是非英语内容错误率高达40%;最重要的是,网络依赖性强,国内用户常因API访问不稳定导致刮削中断。

相比之下,tmm v3的手动方案提供三重保障:

  • 100%人工校验:每个匹配结果都经过肉眼确认
  • 离线元数据缓存:一次刮削永久保存,不受API限制
  • 混合修正能力:自动匹配失败时可手动补充任何字段

实测对比:对同一个包含217部电影的文件夹,Jellyfin自动刮削成功率为68%,而tmm v3手动模式达到100%准确,且平均每部影片节省3分钟纠错时间。

2. 环境准备:避开90%用户会踩的坑

2.1 网络基础配置

由于tmm需要访问themoviedb.org的API,国内网络环境需先完成以下步骤:

  1. Hosts修改(Windows系统):

    # 用管理员权限打开CMD执行 notepad C:\Windows\System32\drivers\etc\hosts

    在文件末尾添加:

    13.224.161.90 api.themoviedb.org

    保存后验证:

    ping api.themoviedb.org
  2. API密钥申请

    • 访问 TMDB开发者页面
    • 注册时注意:
      • 姓名至少2个字符
      • 应用描述需超过50字
      • 使用真实邮箱接收激活邮件

2.2 软件版本选择

务必下载tmm v3.1.17而非新版,原因如下:

版本API调用限制中文支持硬件需求
v3完善
v450次/天部分

推荐从 Archive.org 搜索历史版本,避免官网下载的龟速问题。

3. 电影刮削全流程实战

3.1 基础设置

首次启动tmm需完成关键配置:

  1. 数据源设置

    • 创建新数据库
    • 添加媒体文件夹(建议按/电影/影片名(年份)/的结构)
  2. 刮削器配置

    设置 → 刮削器 → 电影 → 首选: themoviedb.org → 填入API密钥 → 勾选"保存图片到媒体文件夹"
  3. NFO格式选择

    • 强烈建议选用Kodi兼容格式
    • 启用"为每个视频创建独立NFO"

3.2 精准刮削技巧

针对特殊情况的处理方案:

案例1:系列电影识别错误

  • 右键影片 → "搜索并刮削"
  • 手动输入IMDb编号(如tt1234567)
  • 在结果页勾选"锁定匹配"防止后续变更

案例2:多版本电影合并

  1. 选中所有相关文件
  2. 右键 → "编辑电影" → "多版本管理"
  3. 设置主版本并指定不同版本的标签(如"导演剪辑版")

文件命名规范建议

电影/ ├── 肖申克的救赎 (1994)/ │ ├── poster.jpg │ ├── fanart.jpg │ └── The Shawshank Redemption (1994).mkv └── 教父 (1972)/ ├── CD1/ │ └── The Godfather (1972) CD1.mkv └── CD2/ └── The Godfather (1972) CD2.mkv

4. 电视剧整理进阶指南

电视剧刮削比电影复杂得多,核心在于季集编号识别

4.1 文件结构规范

正确示例:

电视剧/ └── 权力的游戏 (2011)/ ├── Season 1/ │ ├── S01E01.mkv │ └── S01E02.mkv └── Season 2/ ├── S02E01.mkv └── S02E02.mkv

异常情况处理:

  • 缺少季编号:右键剧集 → "编辑" → "季" → 手动指定季数
  • 多CD剧集:使用S01E01-CD1格式命名

4.2 元数据增强方案

  1. 自定义缩略图

    • 将图片命名为seasonXX-poster.jpg放入季文件夹
    • 在tmm中右键刷新元数据
  2. 演员信息补全

    • 编辑剧集 → "演员"标签
    • 拖拽图片到对应演员栏位
    • 支持本地图片或网络URL

5. Jellyfin完美集成策略

5.1 媒体库配置要点

在Jellyfin控制台需特别注意:

媒体库类型 → 选择"电影"或"电视剧" 元数据下载器 → 全部取消勾选 图像下载器 → 全部取消勾选 NFO读取 → 强制启用

5.2 常见问题排查

问题:刮削完成但Jellyfin不显示封面解决方案

  1. 检查NFO文件是否包含<thumb>...</thumb>标签
  2. 确认图片文件权限为755
  3. 在Jellyfin执行"刷新元数据"(不勾选"替换所有元数据")

问题:剧集顺序错乱修复步骤

  1. 在tmm中检查季集编号
  2. 修改NFO文件中的<episode>X</episode>字段
  3. 重命名视频文件为SXXEYY格式

6. 效率提升技巧包

6.1 批量操作秘籍

  • 快速重命名: 选中多个文件 → F2 → 使用模板:

    ${movieName} (${year})${' CD'+cd}
  • 元数据导出

    工具 → 批量导出 → 选择"XML+图片"格式

6.2 硬件加速方案

对于超过5000部影片的库,建议:

  1. 将tmm数据库放在SSD上
  2. 设置内存缓存:
    # 在tmm.ini中添加 -Xmx4096m -XX:MaxRAMPercentage=70
  3. 启用后台刮削模式

我在整理一个包含3TB影视资源的库时,通过以上优化将总耗时从18小时压缩到6小时。最关键的是先建立标准文件夹结构,再按类型分批处理——电影优先处理IMDb Top 250,电视剧按首字母顺序推进。遇到无法自动匹配的作品,善用"手动搜索"功能,有时输入导演姓名比片名更有效。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询