如何使用MetaTube插件:让Jellyfin/Emby轻松获取完整元数据的终极指南 🚀
MetaTube插件是一款专为Jellyfin和Emby媒体服务器设计的强大元数据工具,能够自动抓取影片标题、简介、演员、评分等完整信息,支持预告片在线播放和人脸识别裁剪海报,让你的媒体库管理更高效、更专业。
🌟 MetaTube插件核心功能一览
MetaTube插件凭借丰富的功能,成为媒体服务器爱好者的必备工具。以下是它的6大核心优势:
1️⃣ 完整元数据自动抓取
自动获取影片的标题、简介、演员、导演、标签、评分等信息,无需手动编辑,让媒体库瞬间变得专业规范。
2️⃣ 多源搜索与精准匹配
支持通过多个刮削源搜索影片和演员信息,结合智能匹配算法,即使是冷门资源也能快速找到准确数据。
3️⃣ 在线预告片无缝播放
无需下载完整视频,即可生成在线预告片的strm格式文件,点击即可观看,节省存储空间同时提升观影体验。
4️⃣ 智能人脸识别与海报优化
内置人脸识别引擎,自动以人脸为中心裁剪海报图像,支持自定义图片比例和压缩质量,让海报展示更美观。
5️⃣ 元数据自动翻译
支持将标题和简介翻译成多种语言,集成百度、Google、DeepL、OpenAI等多种翻译引擎,满足跨语言需求。
6️⃣ 计划任务自动化管理
提供插件自动更新、元数据整理等计划任务,后台自动运行,减少手动维护成本。
📂 项目目录结构解析
了解MetaTube插件的目录结构,有助于更好地理解其工作原理和扩展方式:
jellyfin-plugin-metatube/
├── Jellyfin.Plugin.MetaTube/ # 插件核心代码目录
│ ├── ApiClient.cs # API客户端实现
│ ├── Configuration/ # 配置相关文件
│ ├── Metadata/ # 元数据模型定义
│ ├── Providers/ # 元数据提供器实现
│ └── ScheduledTasks/ # 计划任务实现
├── scripts/ # 脚本文件目录
├── LICENSE # 许可证文件
├── README.md # 英文说明文档
├── README_ZH.md # 中文说明文档
└── jellyfin-plugin-metatube.sln # 解决方案文件
🚀 快速安装与配置步骤
1️⃣ 获取插件源代码
首先,通过Git克隆项目到本地:
git clone https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metatube.git
2️⃣ 构建插件
使用Visual Studio或dotnet命令构建项目:
cd jellyfin-plugin-metatube
dotnet build
3️⃣ 安装插件到Jellyfin/Emby
将构建生成的.dll文件复制到Jellyfin/Emby的插件目录,重启服务器后在插件管理页面启用MetaTube插件。
4️⃣ 配置插件参数
在插件配置页面(Configuration/configPage.html),你可以设置以下关键参数:
- 服务器地址:MetaTube后端服务的完整URL
- 访问令牌:后端服务的访问令牌(如无则留空)
- 功能开关:启用/禁用预告片、导演信息、演员真实姓名等
- 翻译设置:选择翻译模式(标题、简介或两者)和翻译引擎
⚙️ 高级功能配置指南
🔍 元数据提供器过滤与排序
在配置页面的"Provider"部分,你可以启用电影提供器过滤功能,并按照优先级输入提供器名称(用逗号分隔),例如:
xcity
插件将按照你设置的顺序优先使用指定的提供器获取数据。
🖼️ 海报徽章与图片优化
启用徽章功能后,插件会自动在海报上添加中文字幕徽章。你可以自定义徽章图片URL,建议使用PNG格式以获得最佳效果。
🔄 元数据替换规则设置
通过"Substitution"部分,你可以设置标题、演员、标签的替换规则。每行一条规则,格式为"源文本=目标文本",例如:
HD=高清
SD=标清
留空目标文本可删除源文本。
📝 使用注意事项
- 后端服务依赖:MetaTube插件需要配合后端服务使用,你可以搭建自己的后端或使用公共服务。
- 网络连接:确保媒体服务器能够访问元数据提供器和翻译服务的网络连接。
- 文件命名规范:为获得最佳匹配效果,建议遵循标准的媒体文件命名规范,如
[片名].[年份].[分辨率].[格式]。 - 定期更新:启用计划任务中的"UpdatePluginTask",可自动更新插件到最新版本,获取更多功能和修复。
📄 许可证信息
MetaTube插件采用MIT许可证开源,你可以自由使用、修改和分发,但需遵守以下附加条款:
- 仅供学习和技术交流使用
- 禁止用于商业用途
- 使用时请遵守当地法律法规
通过MetaTube插件,你可以轻松为Jellyfin/Emby媒体服务器添加强大的元数据管理能力。无论是新手还是资深用户,都能快速上手并享受自动化带来的便利。立即尝试,让你的媒体库管理更上一层楼! 🎉
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



