Jellyfin MetaTube 插件｜视频元数据刮削插件 功能详解+配置教程

一、插件作用

MetaTube 是 Jellyfin 的第三方元数据刮削插件，专门用来抓取网络视频的元信息（标题、封面、简介、发布时间、作者、分集信息等）。

适用场景：下载的网络短视频、自媒体视频，本地文件文件名杂乱，Jellyfin原生刮削器识别不到信息，无法自动匹配封面和简介，就用MetaTube。

核心能力：

  1. 自动解析视频内/文件名中的视频ID，抓取元数据、海报封面、简介、作者信息
  2. 支持多平台：B站、YouTube、抖音等平台下载的视频元数据刮取
  3. 支持自动生成艺人/作者条目，合集/播放列表识别
  4. 支持自定义命名规则，批量刮削本地媒体库，不需要手动编辑每一条视频信息

⚠️ 重要区分 MetaTube 不是播放器、不是IPTV插件，不处理直播电视，只负责给本地离线视频补全元数据。 仅作用于已经下载存放在NAS硬盘里的视频文件。

二、前置准备

  1. Jellyfin版本满足插件要求（推荐新版Jellyfin）
  2. 媒体库内视频文件，文件名包含对应平台视频ID（MetaTube依靠ID进行匹配）

    示例命名参考：【12345678】测试标题.mp4，括号内为平台视频ID

三、插件安装步骤

  1. Jellyfin后台 →【插件】→【仓库】，添加MetaTube官方插件仓库地址
  2. 仓库添加完成，切换到【目录】，找到 MetaTube 插件，点击安装
  3. 安装完成，重启Jellyfin服务

四、插件核心设置

打开MetaTube插件配置页面：

  1. 【常规设置】
  • 语言：zh-CN（中文）
  • 自动下载封面：开启，自动抓取视频缩略海报
  • 自动下载简介：开启
  • 自动创建创作者条目：按需开启，开启后会在人物库生成UP主/作者
  1. 【平台设置】 按需开启需要刮削的平台（B站/抖音等），部分平台需要配置Cookie才能获取完整元数据。

    Cookie作用：部分平台限制匿名访问，填入Cookie可以获取高清封面、完整简介。

  2. 【命名匹配规则】 保持默认正则即可；如果自己有自定义文件命名格式，可以修改正则表达式，让插件识别文件内的视频ID。

五、媒体库刮削使用方法

方式1：自动刮削（推荐）

媒体库添加新视频后，Jellyfin自动触发MetaTube元数据抓取。

方式2：手动批量刮削

  1. 进入媒体库，选中媒体库文件夹
  2. 点击【扫描媒体库】，或者右键媒体库【刷新元数据】
  3. MetaTube自动扫描所有视频，识别ID，联网拉取元数据，写入Jellyfin数据库
  4. 刷新前端页面，视频就会显示封面、标题、简介、作者信息

六、排坑要点

  1. 刮削无信息：检查文件名，插件找不到视频ID；核对正则匹配规则。
  2. 抓不到封面/简介：平台限制，需要填入有效Cookie。
  3. 扫描很慢：网络原因，国内访问部分平台接口不稳定，可减少并发数量。
  4. 不生效：确认插件已启用，Jellyfin重启完成；确认媒体库【元数据抓取器】选中MetaTube。