Jellyfin ThePornDB 插件快速上手指南:安装、配置与验证【免费下载链接】Jellyfin.Plugin.ThePornDBJellyfin/Emby Metadata Provider项目地址: https://gitcode.com/gh_mirrors/je/Jellyfin.Plugin.ThePornDBJellyfin ThePornDB 插件是一个面向成人影片库的元数据 Provider,它能自动从 ThePornDB 数据库拉取影片信息、演员资料、厂牌与集合数据,帮你省去手动维护封面和简介的繁琐工作。本文按「安装 → 配置 → 验证」的实际操作流程,带你从零把它跑起来。它能为你的媒体库做什么自动补全影片信息:根据文件名匹配对应作品,导入标题、简介、海报与背景图。自动建立演员库:识别演员与导演,补充头像、简介,还可以用自定义模板展示身材数据、纹身等信息。按厂牌自动归集合:配合定时任务,把同一厂牌(Studio/Site)的影片归入同一个集合,方便浏览。双平台兼容:同时适配 Jellyfin(当前版本面向 10.11)与 Emby(4.9),日常使用方式基本一致。安装前需要检查什么 服务器版本要匹配。每个插件包都标注了适配的 ABI 版本,当前版本 1.6.0.11 面向 Jellyfin 10.11 与 Emby 4.9;如果你的服务器较旧,需要下载对应旧版本安装包,具体对照关系以当前版本 README 为准。服务器要能访问外网。插件运行时要请求 ThePornDB 的元数据接口,网络不通时所有匹配都会失败。准备一个 Token(可选)。配置页提供令牌输入框,用于调用元数据 API,获取方式以官方文档为准;先装后补填也完全可以。如何安装并让 Jellyfin 自动加载插件插件没有独立进程,安装完成后由 Jellyfin/Emby 服务在启动时自动加载,因此「重启服务」就是它的启动方式。两种安装途径任选其一:方式一:插件仓库安装(仅 Jellyfin)打开 Jellyfin 网页控制台,进入「插件 → 常规」。选择「从 URL 添加插件仓库」,填入该插件仓库的 manifest.json 地址(可从项目 README 获取)。保存后刷新插件列表,找到 ThePornDB 并点击安装。方式二:手动安装 zip 包(Jellyfin 与 Emby 通用)从项目 Releases 页下载最新的 zip 安装包。按 Jellyfin/Emby 官方插件文档的指引,将压缩包放入对应插件目录。重启 Jellyfin 或 Emby 服务。⚠️ 下载前核对一下安装包标注的 targetAbi。装错版本会出现插件无法加载或配置页报错。如果你习惯从源码构建,可以克隆仓库后按工程文件自行编译:git clone https://gitcode.com/gh_mirrors/je/Jellyfin.Plugin.ThePornDB构建产物即插件 zip 包,编译细节以仓库内工程文件为准。Jellyfin ThePornDB 插件配置在哪里改安装成功后,在控制台「插件」页找到ThePornDB进入配置页(Emby 侧入口为插件选项编辑器,字段基本一致)。选项很多,但真正高频的只有下面几个:配置项作用使用建议Token元数据接口令牌有就填,没有可留空Use FilePath for matching用完整文件路径参与匹配文件名不够规范时打开Use OpenSubtitlesHash for matching用文件内容哈希匹配改名也能命中,推荐开启Tag Style标签写成 Genre、Tag 或禁用默认 Genre 即可Use Custom Title Format自定义标题模板,如{studio}: {title} ({actors})想统一命名风格时再开Use Unmatched Tag给未匹配上的影片打标记(默认 Missing From ThePornDB)排查匹配率时很有用Disable Actors / Directors / Genres关闭对应元数据写入按需精简数据集合类选项(Add Collection on Site、Collection Type 等)需要配合定时任务使用:开启后到「控制台 → 任务」中运行 ThePornDB 的AddCollection任务,系统就会按厂牌把影片分组;若分组数量不达标,可调整 CollectionMinSize 阈值。如何确认插件已加载成功 ✅控制台「插件」列表中能看到 ThePornDB,且版本号与你服务器 ABI 对应。点开任意一部影片,刷新元数据后能找到匹配结果,详情页出现海报、简介和演员信息。「控制台 → 任务」中出现该插件名下的 Cleanup 等定时任务,说明插件的调度器也注册成功了。常见问题与排障搜索不到结果:先检查文件名是否包含标题与年份;再开启 OpenSubtitlesHash 匹配,它基于文件内容,不受改名影响。Emby 装不上:仓库方式仅支持 Jellyfin,Emby 用户请走手动 zip 安装。改完配置没变化:配置即时保存,但元数据要等重新扫描或手动刷新才会更新。从旧版本升级过:旧版本写入的外部 ID 格式已调整,运行Cleanup任务可迁移清理(以当前版本文档为准)。怀疑请求失败:在 Jellyfin 日志中搜索插件名,可以看到接口请求与匹配过程的具体报错。下一步:深入源码定位问题Configuration/PluginConfiguration.cs:全部配置项的定义与默认值。Providers/:场景、电影、JAV、演员、厂牌等元数据与图片的 Provider 实现。ScheduledTasks/:AddCollection 与 Cleanup 两个定时任务的源码。manifest.json:版本清单,可用来对照服务器 ABI 选择正确的安装包。【免费下载链接】Jellyfin.Plugin.ThePornDBJellyfin/Emby Metadata Provider项目地址: https://gitcode.com/gh_mirrors/je/Jellyfin.Plugin.ThePornDB创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Jellyfin ThePornDB 插件快速上手指南:安装、配置与验证
Jellyfin ThePornDB 插件快速上手指南:安装、配置与验证【免费下载链接】Jellyfin.Plugin.ThePornDBJellyfin/Emby Metadata Provider项目地址: https://gitcode.com/gh_mirrors/je/Jellyfin.Plugin.ThePornDBJellyfin ThePornDB 插件是一个面向成人影片库的元数据 Provider,它能自动从 ThePornDB 数据库拉取影片信息、演员资料、厂牌与集合数据,帮你省去手动维护封面和简介的繁琐工作。本文按「安装 → 配置 → 验证」的实际操作流程,带你从零把它跑起来。它能为你的媒体库做什么自动补全影片信息:根据文件名匹配对应作品,导入标题、简介、海报与背景图。自动建立演员库:识别演员与导演,补充头像、简介,还可以用自定义模板展示身材数据、纹身等信息。按厂牌自动归集合:配合定时任务,把同一厂牌(Studio/Site)的影片归入同一个集合,方便浏览。双平台兼容:同时适配 Jellyfin(当前版本面向 10.11)与 Emby(4.9),日常使用方式基本一致。安装前需要检查什么 服务器版本要匹配。每个插件包都标注了适配的 ABI 版本,当前版本 1.6.0.11 面向 Jellyfin 10.11 与 Emby 4.9;如果你的服务器较旧,需要下载对应旧版本安装包,具体对照关系以当前版本 README 为准。服务器要能访问外网。插件运行时要请求 ThePornDB 的元数据接口,网络不通时所有匹配都会失败。准备一个 Token(可选)。配置页提供令牌输入框,用于调用元数据 API,获取方式以官方文档为准;先装后补填也完全可以。如何安装并让 Jellyfin 自动加载插件插件没有独立进程,安装完成后由 Jellyfin/Emby 服务在启动时自动加载,因此「重启服务」就是它的启动方式。两种安装途径任选其一:方式一:插件仓库安装(仅 Jellyfin)打开 Jellyfin 网页控制台,进入「插件 → 常规」。选择「从 URL 添加插件仓库」,填入该插件仓库的 manifest.json 地址(可从项目 README 获取)。保存后刷新插件列表,找到 ThePornDB 并点击安装。方式二:手动安装 zip 包(Jellyfin 与 Emby 通用)从项目 Releases 页下载最新的 zip 安装包。按 Jellyfin/Emby 官方插件文档的指引,将压缩包放入对应插件目录。重启 Jellyfin 或 Emby 服务。⚠️ 下载前核对一下安装包标注的 targetAbi。装错版本会出现插件无法加载或配置页报错。如果你习惯从源码构建,可以克隆仓库后按工程文件自行编译:git clone https://gitcode.com/gh_mirrors/je/Jellyfin.Plugin.ThePornDB构建产物即插件 zip 包,编译细节以仓库内工程文件为准。Jellyfin ThePornDB 插件配置在哪里改安装成功后,在控制台「插件」页找到ThePornDB进入配置页(Emby 侧入口为插件选项编辑器,字段基本一致)。选项很多,但真正高频的只有下面几个:配置项作用使用建议Token元数据接口令牌有就填,没有可留空Use FilePath for matching用完整文件路径参与匹配文件名不够规范时打开Use OpenSubtitlesHash for matching用文件内容哈希匹配改名也能命中,推荐开启Tag Style标签写成 Genre、Tag 或禁用默认 Genre 即可Use Custom Title Format自定义标题模板,如{studio}: {title} ({actors})想统一命名风格时再开Use Unmatched Tag给未匹配上的影片打标记(默认 Missing From ThePornDB)排查匹配率时很有用Disable Actors / Directors / Genres关闭对应元数据写入按需精简数据集合类选项(Add Collection on Site、Collection Type 等)需要配合定时任务使用:开启后到「控制台 → 任务」中运行 ThePornDB 的AddCollection任务,系统就会按厂牌把影片分组;若分组数量不达标,可调整 CollectionMinSize 阈值。如何确认插件已加载成功 ✅控制台「插件」列表中能看到 ThePornDB,且版本号与你服务器 ABI 对应。点开任意一部影片,刷新元数据后能找到匹配结果,详情页出现海报、简介和演员信息。「控制台 → 任务」中出现该插件名下的 Cleanup 等定时任务,说明插件的调度器也注册成功了。常见问题与排障搜索不到结果:先检查文件名是否包含标题与年份;再开启 OpenSubtitlesHash 匹配,它基于文件内容,不受改名影响。Emby 装不上:仓库方式仅支持 Jellyfin,Emby 用户请走手动 zip 安装。改完配置没变化:配置即时保存,但元数据要等重新扫描或手动刷新才会更新。从旧版本升级过:旧版本写入的外部 ID 格式已调整,运行Cleanup任务可迁移清理(以当前版本文档为准)。怀疑请求失败:在 Jellyfin 日志中搜索插件名,可以看到接口请求与匹配过程的具体报错。下一步:深入源码定位问题Configuration/PluginConfiguration.cs:全部配置项的定义与默认值。Providers/:场景、电影、JAV、演员、厂牌等元数据与图片的 Provider 实现。ScheduledTasks/:AddCollection 与 Cleanup 两个定时任务的源码。manifest.json:版本清单,可用来对照服务器 ABI 选择正确的安装包。【免费下载链接】Jellyfin.Plugin.ThePornDBJellyfin/Emby Metadata Provider项目地址: https://gitcode.com/gh_mirrors/je/Jellyfin.Plugin.ThePornDB创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考