XRDB

XRDB，扩展评级数据库，生成带有动态评级、质量徽章和导出就绪集成的海报、背景、缩略图和标志艺术品。

XRDB, the Extended Rating Database, generates posters, backgrounds, thumbnails and logo artwork with dynamic ratings, quality badges and export-ready integrations.

原始信息汇总

XRDB: eXtended Ratings DataBase 数据集概述

数据集基本信息

• 名称: XRDB (eXtended Ratings DataBase)
• 构建者: IbbyLabs
• 主要功能: 生成带有动态评分、质量徽章和导出就绪集成的海报、背景图、缩略图和标志图艺术作品。

核心特性

• 支持生成海报、背景图、缩略图和标志图。
• 集成动态评分和质量徽章。
• 提供导出就绪的集成方案。

技术实现与部署

• 本地运行: 使用Node 22.x，通过 git clone、npm install、npm run build 和 npm run start 启动，应用默认运行在 http://localhost:3000。
• Docker支持: 提供两种Docker Compose文件。
  • compose.yaml: 适用于VPS堆栈，使用预构建的GHCR镜像，与Traefik风格堆栈兼容。
  • local-compose.yaml: 适用于本地源码构建和测试。
• 容器镜像: 多架构容器镜像发布在 ghcr.io/ibbylabs/xrdb，支持 latest 和版本标签（如 v1.0.0）。
• 环境配置: 提供 env.selfhost.template（最小化自托管设置）和 env.template（完整参考）模板文件。

数据源与API集成

• 默认服务器端提供商密钥: 支持配置TMDB、MDBList等，密钥存储在服务器环境变量中。
• 支持的评分/数据提供商: 包括TMDB、MDBList、Fanart、Simkl、MyAnimeList（MAL）、Trakt、OMDb等。
• 服务器端客户端ID扩展: 可通过环境变量启用特定提供商的直接API路径（如MAL、Trakt、Simkl）。
• 回退机制: 当主要提供商不可用时，具备智能回退策略（例如，MAL未配置时回退至Jikan，再回退至MDBList）。

配置与管理

• 配置器: 提供基于密码保护的UUID保存配置文件功能，支持导入/导出和在多设备间恢复设置。
• AIOMetadata导出: 支持精简的UUID链接和行内参数URL两种模式。
• 凭证隐藏: 可在UI中隐藏凭证显示。
• 海报ID源选择: 默认使用IMDb以确保兼容性，同时支持TMDB等类型感知的ID。

API端点与使用示例

• 主图像端点: GET /{type}/{id}.jpg?ratings={providers}&lang={lang}&ratingStyle={style}...
  • 类型 (type): poster, backdrop, logo
• 剧集缩略图端点: GET /thumbnail/{id}/S{season}E{episode}.jpg?thumbnailRatings=tmdb,imdb&lang={lang}...
• 响应格式: 海报和背景图返回JPEG；标志图请求可能根据透明度保留情况返回PNG。
• 示例:
  • 带有IMDb和TMDB评分的海报: /poster/tt0133093.jpg?ratings=imdb,tmdb&lang=en
  • 原始语言海报: /poster/tt0089881.jpg?lang=original
  • 带有底部评分行的背景图: /backdrop/tmdb:tv:1399.jpg?backdropRatings=tmdb,imdb&backdropBottomRatingsRow=true&lang=en
  • 使用XRDBID的剧集缩略图: /thumbnail/xrdbid:tt0944947/S01E01.jpg?thumbnailRatings=tmdb,imdb&lang=en

渲染选项与定制

• 评分样式: 支持普通 (plain)、方形 (square)、玻璃 (glass) 等样式。
• 布局控制: 支持顶部/底部行、分侧布局、居中堆叠、右侧垂直堆叠等。
• 质量徽章: 支持4K、蓝光、HDR10、杜比视界、杜比全景声等本地资源徽章，认证徽章包含AGE标签。
• 输出尺寸控制: 支持对海报、背景图和标志图的输出尺寸进行更多控制。
• 透明度处理: 透明的提供商图标在所有徽章样式中保持透明。

性能与扩展性

• 推荐服务器要求 (用于高性能实时图像渲染):
  • 最低推荐: 4 vCPU, 4 GB RAM。
• 缓存与预热: 支持启动和后台更新的缓存预热，以减少首次加载延迟。
• 公共/共享主机优化: 提供轻量级配置预设，以优化冷渲染和应对突发流量。
• 代理或插件推荐设置: 为公共实例提供了评分列表、流媒体徽章开关等优化建议。

安全与访问控制

• 请求保护: 使用可选的独立XRDB请求密钥 (XRDB_REQUEST_API_KEY)。
• 反向代理集成: 提供与Authelia等认证系统集成的模板和指南，可绕过图像和代理端点的认证以兼容客户端（如Stremio, Jellyfin）。

发布与维护

• 发布流程: 通过 npm run release:patch/minor/major 触发，自动生成GitHub发布说明和Docker镜像。
• 文档与预览: 发布自动化会重新生成README文档中的图片，并支持使用独立的环境变量 (XRDB_README_PREVIEW_TMDB_KEY 等) 进行预览流量隔离。

搜集汇总

数据集介绍

构建方式

在媒体元数据与艺术品生成领域，XRDB数据集通过集成多源评级数据与动态图像渲染技术构建而成。其核心机制依赖于服务器端配置的API密钥，从TMDB、MDBList、Fanart等权威提供商获取评级与元数据，并利用智能回退策略确保数据可用性。数据集通过Node.js环境进行本地构建与部署，支持Docker容器化，采用预构建的GHCR镜像实现跨平台一致性。构建过程中注重缓存预热与性能优化，通过版本化渲染缓存确保图像输出的时效性与稳定性。

特点

XRDB数据集具备高度可定制化的图像生成能力，支持海报、背景图、标志与缩略图等多种艺术品类型，并动态嵌入来自IMDb、TMDB、烂番茄等多平台的评级标识。其特色在于灵活的布局与样式配置，例如玻璃质感、方形或简约风格的评级徽章，以及针对动漫内容的专门优化。数据集采用服务器端密钥管理，避免凭证暴露，同时支持密码保护的UUID配置档案，实现跨设备无缝迁移。此外，通过智能回退与缓存机制，保障了高并发场景下的响应速度与可靠性。

使用方法

使用XRDB数据集时，开发者可通过RESTful API端点直接请求图像资源，例如通过`/poster/{id}.jpg`获取海报，并利用查询参数指定评级提供商、语言与样式。数据集支持本地部署，通过Git克隆仓库后运行Node.js构建脚本启动服务，或使用Docker Compose快速部署于云服务器。对于集成场景，可配置环境变量以启用特定提供商API，并通过AIOMetadata模式生成轻量级链接。数据集还提供实时预览图库与渲染选项对比，便于用户评估输出效果，并针对公共托管场景提供了性能优化预设。

背景与挑战

背景概述

在多媒体内容管理领域，动态生成带有评级信息的视觉素材已成为提升用户体验的关键需求。XRDB（eXtended Ratings DataBase）数据集由IbbyLabs构建，旨在为影视作品生成海报、背景图、缩略图及标志等艺术作品，并集成动态评级、质量徽章及可导出的工作流。该数据集的核心研究问题聚焦于如何高效聚合多源评级数据，并实现跨平台的艺术作品自动化生成，从而服务于媒体工具、插件集成及工作流优化。其影响力体现在为开源社区提供了灵活可扩展的视觉内容生成解决方案，推动了影视元数据与艺术呈现的深度融合。

当前挑战

XRDB数据集致力于解决影视艺术作品生成中多源评级整合与动态渲染的挑战。具体而言，其面临的领域挑战包括：如何从TMDB、MDBList、MyAnimeList等异构数据源中实时获取并融合评级信息，同时确保生成图像的质量与风格一致性；在构建过程中，数据集需应对多语言支持、跨平台兼容性以及高并发渲染的性能瓶颈。此外，数据集的持续维护还涉及缓存优化、提供商故障回退机制以及安全密钥管理的复杂性，这些均对系统的可靠性与可扩展性提出了较高要求。

常用场景

经典使用场景

在多媒体内容管理与推荐系统领域，XRDB数据集通过整合TMDB、IMDb、MyAnimeList等多个平台的评分数据与元信息，为影视作品的海报、背景图及标志图像生成动态评级标签与质量徽章。其核心应用场景在于自动化构建视觉化评级界面，使得流媒体平台、媒体库工具及第三方插件能够实时呈现跨源聚合的观众评价与专业评分，从而提升内容展示的信息密度与用户体验。

实际应用

在实际部署中，XRDB广泛集成于Stremio、Jellyfin等媒体中心应用以及自定义流媒体代理服务，通过生成带有多重评级标识的定制化图像，辅助用户快速甄别内容质量。其支持多语言渲染与自适应布局的特性，亦被应用于全球化影视展示平台、动漫社区资料库及智能电视界面优化，显著降低了内容策展与个性化推荐系统的开发复杂度。

衍生相关工作

围绕XRDB数据集衍生的经典工作包括基于其API构建的AIOMetadata元数据增强框架、Torrentio流媒体徽章集成模块以及Viren070容器化部署模板。这些衍生工具进一步拓展了XRDB在自动化媒体工作流中的应用边界，例如通过代理层实现元数据翻译与填充，或利用Docker堆栈实现高可用、可扩展的分布式图像渲染服务，形成了以评级可视化为中心的开源工具生态系统。