Stunning Ratings.
Stateless API.

Act as an expert addon developer. I want to implement the ERDB Stateless API into my media center addon. CONFIG INPUT Add a single text field called "erdbConfig" (base64url). The user will paste it from the ERDB site after configuring there. Do NOT hardcode API keys or base URL. Always use cfg.baseUrl from erdbConfig. DECODE Node/JS: const cfg = JSON.parse(Buffer.from(erdbConfig, 'base64url').toString('utf8')); FULL API REFERENCE Endpoint: GET /{type}/{id}.jpg?...queryParams Parameter | Values | Default type (path) | poster, backdrop, logo | none id (path) | IMDb (tt...), TMDB (tmdb:id, tmdb:movie:id, tmdb:tv:id), Kitsu (kitsu:id), AniList, MAL, TVDB, AniDB | none tmdbIdScope | soft, strict | soft ratings | tmdb, mdblist, imdb, tomatoes, tomatoesaudience, letterboxd, metacritic, metacriticuser, trakt, simkl, rogerebert, myanimelist, anilist, kitsu (global fallback) | all posterRatings | tmdb, mdblist, imdb, tomatoes, tomatoesaudience, letterboxd, metacritic, metacriticuser, trakt, simkl, rogerebert, myanimelist, anilist, kitsu (poster only) | all backdropRatings | tmdb, mdblist, imdb, tomatoes, tomatoesaudience, letterboxd, metacritic, metacriticuser, trakt, simkl, rogerebert, myanimelist, anilist, kitsu (backdrop only) | all logoRatings | tmdb, mdblist, imdb, tomatoes, tomatoesaudience, letterboxd, metacritic, metacriticuser, trakt, simkl, rogerebert, myanimelist, anilist, kitsu (logo only) | all lang | Any TMDB ISO 639-1 code (en, it, fr, es, de, ja, ko, etc.) | en genreBadge | off, text, icon, both (global fallback) | off posterGenreBadge | off, text, icon, both (poster only) | off backdropGenreBadge | off, text, icon, both (backdrop only) | off logoGenreBadge | off, text, icon, both (logo only) | off genreBadgeStyle | glass, square, plain (global fallback) | glass posterGenreBadgeStyle | glass, square, plain (poster only) | glass backdropGenreBadgeStyle| glass, square, plain (backdrop only) | glass logoGenreBadgeStyle | glass, square, plain (logo only) | glass genreBadgePosition | topLeft, topCenter, topRight, bottomLeft, bottomCenter, bottomRight (global fallback) | topLeft posterGenreBadgePosition| topLeft, topCenter, topRight, bottomLeft, bottomCenter, bottomRight (poster only) | topLeft backdropGenreBadgePosition| topLeft, topCenter, topRight, bottomLeft, bottomCenter, bottomRight (backdrop only) | topLeft logoGenreBadgePosition | topLeft, topCenter, topRight, bottomLeft, bottomCenter, bottomRight (logo only) | topLeft streamBadges | auto, on, off (global fallback) | auto posterStreamBadges | auto, on, off (poster only) | auto backdropStreamBadges | auto, on, off (backdrop only) | auto qualityBadgesSide | left, right (poster top bottom layout only) | left posterQualityBadgesPosition | auto, left, right (poster top or bottom only) | auto posterQualityBadges | certification, netflix, hbo, primevideo, disneyplus, appletvplus, hulu, paramountplus, peacock, 4k, bluray, hdr, dolbyvision, dolbyatmos, remux (poster only, empty string disables all) | all backdropQualityBadges | certification, netflix, hbo, primevideo, disneyplus, appletvplus, hulu, paramountplus, peacock, 4k, bluray, hdr, dolbyvision, dolbyatmos, remux (backdrop only, empty string disables all)| all qualityBadgesStyle | glass, square, plain, media, silver (global fallback) | glass posterQualityBadgesStyle| glass, square, plain, media, silver (poster only) | glass backdropQualityBadgesStyle| glass, square, plain, media, silver (backdrop only) | glass posterQualityBadgesMax | Number (1+) | auto backdropQualityBadgesMax| Number (1+) | auto providerAppearance | base64url or JSON provider overrides for icon, accent, stacked chrome, and stacked element offsets | none ratingPresentation | standard, minimal, average, dual, dual-minimal, editorial, blockbuster | standard aggregateRatingSource | overall, critics, audience | overall aggregateAccentMode | source, genre, custom | source aggregateAccentColor | Hex color (used when aggregateAccentMode=custom) | #a78bfa aggregateAccentBarOffset| Number (-12 to 12, aggregate badges only) | 0 aggregateAccentBarVisible| true, false (aggregate compact/labeled accent line toggle) | true ratingValueMode | native, normalized, normalized100 | native ratingStyle (posterRatingStyle, backdropRatingStyle, logoRatingStyle aliases, style legacy) | glass, square, plain, stacked | glass genreBadgeScale | Number (70 to 200) (global fallback) | 100 posterGenreBadgeScale | Number (70 to 200) | 100 backdropGenreBadgeScale | Number (70 to 200) | 100 logoGenreBadgeScale | Number (70 to 200) | 100 posterRatingBadgeScale | Number (70 to 150) | 100 backdropRatingBadgeScale| Number (70 to 150) | 100 logoRatingBadgeScale | Number (70 to 150) | 100 posterQualityBadgeScale| Number (70 to 150) | 100 backdropQualityBadgeScale| Number (70 to 150) | 100 imageText | original, clean, alternative, random | original posterImageSize | normal (580x859), large (1280x1896), 4k (2000x2926) | normal posterArtworkSource | tmdb, fanart, cinemeta, random (poster artwork source) | tmdb backdropArtworkSource | tmdb, fanart, cinemeta, random (backdrop artwork source) | tmdb posterRatingsLayout | top, bottom, left, right, top bottom, left right | top bottom posterRatingsMax | Number (1+) | auto posterRatingsMaxPerSide | Number (1+) | auto posterEdgeOffset | Number (0 to 80, poster edge badges only) | 0 backdropRatingsLayout | center, right, right vertical | center backdropRatingsMax | Number (1+) | auto posterSideRatingsPosition | top, middle, bottom, custom | top posterSideRatingsOffset | Number (0 to 100, custom only) | 50 backdropSideRatingsPosition | top, middle, bottom, custom | top backdropSideRatingsOffset | Number (0 to 100, custom only) | 50 logoRatingsMax | Number (1+) | auto logoBackground | transparent, dark | transparent logoArtworkSource | tmdb, fanart, cinemeta, random | tmdb erdbKey | ERDB request key when the host enables route protection | none tmdbKey (REQUIRED) | Your TMDB v3 API Key | none mdblistKey (REQUIRED) | Your MDBList.com API Key | none fanartKey | Your Fanart API Key (used first for fanart sources) | service fallback when available simklClientId | Your SIMKL client_id for direct SIMKL ratings | none TMDB NOTE: Default tmdbIdScope=soft keeps compatibility and accepts tmdb:id. Set tmdbIdScope=strict to require tmdb:movie:id or tmdb:tv:id for backdrop and logo so TMDB movie and TV collisions cannot return incorrect artwork. ACCESS NOTE: erdbKey is optional and only needed when the ERDB host protects render and proxy routes with ERDB_REQUEST_API_KEY or ERDB_REQUEST_API_KEYS. STYLE NOTE: Transparent provider icons stay transparent in every style. In glass, icons with transparency such as Kitsu render on a neutral inner chip with an accent ring to avoid accent color bleed through. QUALITY NOTE: Media quality badges use local asset based artwork for 4K, Bluray, HDR10, Dolby Vision, and Dolby Atmos. Certification badges include a small AGE label above the rating. FANART NOTE: fanartKey is optional. If present, ERDB uses your key first for fanart poster, backdrop, and logo requests. If fanartKey is blank, ERDB falls back to ERDB_FANART_API_KEY or FANART_API_KEY when the server has one. POSTER NOTE: posterArtworkSource=fanart uses fanart.tv poster art for original, clean, and alternative poster modes when a fanart key is available. Original and clean use the top ranked fanart image. Alternative uses the next ranked fanart image when one exists. posterArtworkSource=cinemeta uses the official MetaHub Cinemeta poster when ERDB can resolve an IMDb ID, then falls back to TMDB. POSTER SIZE NOTE: posterImageSize controls the poster output target. normal=580x859, large=1280x1896, 4k=2000x2926. BACKDROP NOTE: backdropArtworkSource=fanart uses fanart.tv moviebackground or showbackground art for original, clean, and alternative backdrop modes when a fanart key is available. Original and clean use the top ranked fanart image. Alternative uses the next ranked fanart image when one exists. backdropArtworkSource=cinemeta uses the official MetaHub Cinemeta backdrop when ERDB can resolve an IMDb ID, then falls back to TMDB. LOGO NOTE: logoArtworkSource=fanart uses fanart.tv HD or clear logo assets when a fanart key is available. logoArtworkSource=cinemeta uses the official MetaHub Cinemeta logo when ERDB can resolve an IMDb ID, then falls back to TMDB. FUTURE NOTE: season aware fanart support is a strong next step for TV because fanart.tv exposes seasonposter and seasonthumb assets. INTEGRATION REQUIREMENTS 1. Use ONLY the "erdbConfig" field (no modal and no extra settings panels). 2. Add toggles to enable or disable poster, backdrop, and logo. 3. If a type is disabled, keep the original artwork (do not call ERDB for that type). 4. Build ERDB URLs using the decoded config and inject them into both catalog and meta responses. PER TYPE SETTINGS poster : posterImageSize = cfg.posterImageSize (normal, large, 4k) poster : ratingStyle = cfg.posterRatingStyle, imageText = cfg.posterImageText backdrop : ratingStyle = cfg.backdropRatingStyle, imageText = cfg.backdropImageText logo : ratingStyle = cfg.logoRatingStyle, logoBackground = cfg.logoBackground all : genreBadge = cfg.genreBadge, genreBadgeStyle = cfg.genreBadgeStyle, genreBadgePosition = cfg.genreBadgePosition, genreBadgeScale = cfg.genreBadgeScale (optional global fallbacks) poster : genreBadge = cfg.posterGenreBadge, genreBadgeStyle = cfg.posterGenreBadgeStyle, genreBadgePosition = cfg.posterGenreBadgePosition, genreBadgeScale = cfg.posterGenreBadgeScale backdrop : genreBadge = cfg.backdropGenreBadge, genreBadgeStyle = cfg.backdropGenreBadgeStyle, genreBadgePosition = cfg.backdropGenreBadgePosition, genreBadgeScale = cfg.backdropGenreBadgeScale logo : genreBadge = cfg.logoGenreBadge, genreBadgeStyle = cfg.logoGenreBadgeStyle, genreBadgePosition = cfg.logoGenreBadgePosition, genreBadgeScale = cfg.logoGenreBadgeScale poster artwork source : use cfg.posterArtworkSource for poster original, clean, or alternative backdrop artwork source : use cfg.backdropArtworkSource for backdrop original, clean, or alternative logo artwork source : use cfg.logoArtworkSource when rendering logo output Ratings providers can be set per type via cfg.posterRatings / cfg.backdropRatings / cfg.logoRatings (fallback to cfg.ratings). Provider order is respected. Use cfg.ratingValueMode to keep provider native scales or normalize everything to ten point or rounded hundred point values. Rating presentation can be set per type via cfg.posterRatingPresentation / cfg.backdropRatingPresentation / cfg.logoRatingPresentation (fallback to cfg.ratingPresentation). Aggregate source can be set per type via cfg.posterAggregateRatingSource / cfg.backdropAggregateRatingSource / cfg.logoAggregateRatingSource (fallback to cfg.aggregateRatingSource). Use cfg.aggregateAccentMode to keep source colours, match the genre badge, or force a custom aggregate accent through cfg.aggregateAccentColor. Use cfg.aggregateAccentBarOffset to nudge the aggregate badge accent bar up or down a few pixels in compact, compact dual, labeled, and dual aggregate layouts. Use cfg.aggregateAccentBarVisible=false to hide the compact or labeled aggregate accent line entirely. Editorial presentation gives posters a fixed top left print style and falls back to the labeled average badge on backdrop and logo output. Use cfg.posterEdgeOffset to push poster side rating stacks, side quality columns, and corner genre badges inward from the poster edges. Use cfg.qualityBadgesSide for poster top bottom layouts and cfg.posterQualityBadgesPosition for poster top or bottom layouts. Quality badge visibility/style/max can be set per type via cfg.posterQualityBadges / cfg.backdropQualityBadges, cfg.posterQualityBadgesStyle / cfg.backdropQualityBadgesStyle, and cfg.posterQualityBadgesMax / cfg.backdropQualityBadgesMax. Rating badge max and badge scale can be set per type via cfg.posterRatingsMax / cfg.backdropRatingsMax / cfg.logoRatingsMax plus cfg.posterRatingBadgeScale / cfg.backdropRatingBadgeScale / cfg.logoRatingBadgeScale. Genre badge mode/style/position/scale can be set per type via cfg.posterGenreBadge* / cfg.backdropGenreBadge* / cfg.logoGenreBadge* and fall back to the shared cfg.genreBadge* fields. Quality badge scale can be set per type via cfg.posterQualityBadgeScale / cfg.backdropQualityBadgeScale. Provider icon overrides can be shared through cfg.providerAppearance. Send base64url or raw JSON shaped like {"trakt":{"iconUrl":"https://...","accentColor":"#7c3aed","iconScalePercent":116,"stackedWidthPercent":88,"stackedSurfaceOpacityPercent":72,"stackedAccentMode":"logo","stackedLineVisible":false,"stackedLineWidthPercent":88,"stackedIconOffsetY":-6,"stackedValueOffsetY":4}}. Use cfg.posterSideRatingsPosition for poster side layouts and cfg.backdropSideRatingsPosition for backdrop right vertical stacks. If either field is custom, send the matching cfg.posterSideRatingsOffset or cfg.backdropSideRatingsOffset as a 0 to 100 vertical anchor. Legacy cfg.sideRatingsPosition and cfg.sideRatingsOffset remain accepted as fallbacks. URL BUILD const typeRatingStyle = type === 'poster' ? cfg.posterRatingStyle : type === 'backdrop' ? cfg.backdropRatingStyle : cfg.logoRatingStyle; const typeImageText = type === 'backdrop' ? cfg.backdropImageText : cfg.posterImageText; ${cfg.baseUrl}/${type}/${id}.jpg?erdbKey=${cfg.erdbKey}&tmdbKey=${cfg.tmdbKey}&mdblistKey=${cfg.mdblistKey}&fanartKey=${cfg.fanartKey}&ratings=${cfg.ratings}&posterRatings=${cfg.posterRatings}&backdropRatings=${cfg.backdropRatings}&logoRatings=${cfg.logoRatings}&lang=${cfg.lang}&ratingValueMode=${cfg.ratingValueMode}&genreBadge=${cfg.genreBadge}&genreBadgeStyle=${cfg.genreBadgeStyle}&genreBadgePosition=${cfg.genreBadgePosition}&genreBadgeScale=${cfg.genreBadgeScale}&posterGenreBadge=${cfg.posterGenreBadge}&backdropGenreBadge=${cfg.backdropGenreBadge}&logoGenreBadge=${cfg.logoGenreBadge}&posterGenreBadgeStyle=${cfg.posterGenreBadgeStyle}&backdropGenreBadgeStyle=${cfg.backdropGenreBadgeStyle}&logoGenreBadgeStyle=${cfg.logoGenreBadgeStyle}&posterGenreBadgePosition=${cfg.posterGenreBadgePosition}&backdropGenreBadgePosition=${cfg.backdropGenreBadgePosition}&logoGenreBadgePosition=${cfg.logoGenreBadgePosition}&posterGenreBadgeScale=${cfg.posterGenreBadgeScale}&backdropGenreBadgeScale=${cfg.backdropGenreBadgeScale}&logoGenreBadgeScale=${cfg.logoGenreBadgeScale}&streamBadges=${cfg.streamBadges}&posterStreamBadges=${cfg.posterStreamBadges}&backdropStreamBadges=${cfg.backdropStreamBadges}&qualityBadgesSide=${cfg.qualityBadgesSide}&posterQualityBadgesPosition=${cfg.posterQualityBadgesPosition}&posterQualityBadges=${cfg.posterQualityBadges}&backdropQualityBadges=${cfg.backdropQualityBadges}&qualityBadgesStyle=${cfg.qualityBadgesStyle}&posterQualityBadgesStyle=${cfg.posterQualityBadgesStyle}&backdropQualityBadgesStyle=${cfg.backdropQualityBadgesStyle}&posterQualityBadgesMax=${cfg.posterQualityBadgesMax}&backdropQualityBadgesMax=${cfg.backdropQualityBadgesMax}&providerAppearance=${cfg.providerAppearance}&ratingPresentation=${cfg.ratingPresentation}&aggregateRatingSource=${cfg.aggregateRatingSource}&aggregateAccentMode=${cfg.aggregateAccentMode}&aggregateAccentColor=${cfg.aggregateAccentColor}&aggregateAccentBarOffset=${cfg.aggregateAccentBarOffset}&aggregateAccentBarVisible=${cfg.aggregateAccentBarVisible}&ratingStyle=${typeRatingStyle}&posterRatingBadgeScale=${cfg.posterRatingBadgeScale}&backdropRatingBadgeScale=${cfg.backdropRatingBadgeScale}&logoRatingBadgeScale=${cfg.logoRatingBadgeScale}&posterQualityBadgeScale=${cfg.posterQualityBadgeScale}&backdropQualityBadgeScale=${cfg.backdropQualityBadgeScale}&imageText=${typeImageText}&posterImageSize=${cfg.posterImageSize}&posterArtworkSource=${cfg.posterArtworkSource}&backdropArtworkSource=${cfg.backdropArtworkSource}&posterRatingsLayout=${cfg.posterRatingsLayout}&posterRatingsMax=${cfg.posterRatingsMax}&posterRatingsMaxPerSide=${cfg.posterRatingsMaxPerSide}&posterEdgeOffset=${cfg.posterEdgeOffset}&backdropRatingsLayout=${cfg.backdropRatingsLayout}&backdropRatingsMax=${cfg.backdropRatingsMax}&posterSideRatingsPosition=${cfg.posterSideRatingsPosition}&posterSideRatingsOffset=${cfg.posterSideRatingsOffset}&backdropSideRatingsPosition=${cfg.backdropSideRatingsPosition}&backdropSideRatingsOffset=${cfg.backdropSideRatingsOffset}&logoRatingsMax=${cfg.logoRatingsMax}&logoBackground=${cfg.logoBackground}&logoArtworkSource=${cfg.logoArtworkSource} Omit imageText when type=logo. Skip any params that are undefined. Keep empty ratings/posterRatings/backdropRatings/logoRatings to disable rating providers. Keep empty posterQualityBadges/backdropQualityBadges to hide quality badges for those types.