XRDB | eXtended Ratings DataBase

Live Ratings.
Stateless delivery.

XRDB, eXtended Ratings DataBase, builds posters, backdrops, thumbnails, and logos from one configuration. Tune artwork, export integration settings, and deploy the same output model across addons and media tools.

Checking the latest release on GitHub now.

Need help with XRDB, ratings, or proxy setup?

Join the XRDB communities for help with rendering issues, badges, language settings, or addon setup. The AIOStreams channel is useful for shared troubleshooting, and the official XRDB server is the main project home.

If an invite does not open or has expired, message @ibbys89 on Discord.
Poster, backdrop, and logo output
One config string for every integration
Manifest proxy for Stremio addons

Workspace

Configurator & Proxy

Tune layout, ratings, badges, and language once, then export a shareable config string or generate a proxy manifest from the same state. Saved workspace values stay in this browser until you copy or export them.

Shared workspaceLive previewConfig string exportProxy manifest export
Setup Mode

Simple View

Simple keeps the high signal controls in front of you. Presets, keys, media targeting, and the most visible artwork switches stay easy to reach.

Not sure what to pick?

The guide recommends a preset based on deployment, density, and how much manual tuning you expect to do afterwards.

Wizard Summary
Custom
No preset applied yet

Apply a preset to get a curated starting point, then keep tuning from there.

Workspace

Save the shared XRDB settings plus proxy manifest setup to this browser, or export them as a JSON file.

Saved workspace values only affect this page. Share the config string or the generated proxy manifest if you want the same settings somewhere else.

Access Keys

Optional. Only needed when the XRDB host enables request protection. When present, the configurator carries it into previews, config strings, proxy manifests, and exported URL patterns.

Soft is recommended for compatibility. Switch to Strict if you sometimes see incorrect logo or backdrop artwork from TMDB ID collisions.

Optional. Recommended. Your key is used first. If left blank, XRDB falls back to the service key when one exists. This helps if the shared service key is rate limited or blocked later.

Media Target
Type
Media ID
Add TMDB key for lang
XRDB ID Guide

Accepted IDs, route shapes, and preview input rules

The Media ID field above accepts a base title ID for posters, backdrops, and logos. Thumbnail previews need an episode target. Use this guide to match the field input, the exported route, and the most common scoped query params without guessing.

Current preview type
Poster
poster
What goes in Media ID
tt0133093

Use one base title ID only. Movie, show, and anime poster lookups all start from a single base ID.

Route XRDB generates
/poster/tt0133093.jpg

The preview input above is the ID payload. The final route keeps the same base ID, then adds the artwork path and file format for that image type.

Input examples
tt0133093tmdb:movie:603tmdb:tv:1399xrdbid:tt0944947mal:16498
Route examples
/poster/tt0133093.jpg
/poster/tmdb:movie:603.jpg
/poster/tmdb:tv:1399.jpg
Accepted base ID families
IMDb

Best general base ID for posters and simple movie or show lookups.

tt0133093tt0944947
Typed TMDB

Best when movie and TV type must stay explicit. Required by Strict TMDB scope for backdrop and logo requests.

tmdb:movie:603tmdb:tv:1399
XRDB canon ID

Keeps an IMDb base ID explicit in proxy and episodic workflows.

xrdbid:tt0944947
TVDB

Supported for series and episode targeting when your upstream IDs come from TVDB.

tvdb:121361
Anime IDs

Use the native anime provider ID when your source does not begin with IMDb or TMDB.

anilist:16498mal:16498anidb:5114kitsu:7442
Movie, show, and episode rules
Poster input
baseId

Example: tt0133093 or tmdb:movie:603

Backdrop input
baseId

Example: tmdb:tv:1399 or xrdbid:tt0944947

Logo input
baseId

Example: tmdb:movie:603 or tmdb:tv:1399

Thumbnail input
seriesId:season:episode

Example: tt0944947:1:1 or tmdb:tv:1399:1:1

Kitsu thumbnail input
seriesId:episode

Example: kitsu:7442:1

Strict TMDB and route safety

If you enable Strict TMDB scope, backdrop and logo requests must stay typed as tmdb:movie:603 or tmdb:tv:1399. Plain tmdb:603 is ambiguous and will be rejected.

Poster routes can stay on IMDb or another supported base ID when that fits your source better. The export panels below show the full scoped query string XRDB will generate for your current workspace.

High signal query params
idSource=tmdb

Pins poster, backdrop, and logo exports to typed TMDB route patterns.

tmdbIdScope=strict

Requires tmdb:movie:id or tmdb:tv:id for backdrop and logo requests.

thumbnailEpisodeArtwork=still|series

Controls whether thumbnails prefer the episode still or the series backdrop source.

thumbnailRatings=tmdb,imdb

Chooses the thumbnail specific rating providers without affecting poster, backdrop, or logo routes.

Presentation
Rating Style
Artwork Text
Poster Size
Artwork Source
Genre Badge
Stream Badges
Showcase
Rich visual board with the live result and support samples.
Poster
4K
HDR
DV
Add a TMDB key to unlock the live render. The center stage will swap this placeholder for the real output.
Presentation
Standard
Style
Pill Glass
Providers
16 active
Genre samples

Curated renders show how the current genre badge choices land across media types.

Add a TMDB key to load the sample board.
Quick notes

Showcase keeps the live render visible while the side tiles explain badge choices and the current output mode.

PosterStandard16 active
Add a TMDB key if you want the showcase sample board to render alongside the live preview.
Genre Badge Samples

Curated movie, show, animation, and anime renders that keep the badge decision fixed while you compare mode, style, and placement.

Add a TMDB key above to load the curated sample board.

Use this when another tool expects one XRDB config field. The settings travel inside this string, not inside your saved workspace by itself.

Add TMDB key and MDBList key to generate the config string.

Add TMDB key and MDBList key to generate a valid config string.

These presets keep background and logo on type aware TMDB IDs. Poster follows the selected poster mode. Episode thumbs follow the selected episode mode and keep their own thumbnail ratings, artwork, text, and layout settings.

Poster ID source

Determines which database ID to include in poster URLs. Auto and typed TMDB are the same export mode, so the UI only shows the two distinct behaviors.

Episode ID source

Pick the episode ID family that matches the source best. XRDBID provides stronger canonical mapping for difficult episodic cases.

Thumbnail episode artwork

Default is episode still for thumbnails so they stay distinct from normal backdrops.

Backdrop episode artwork

Default is series backdrop for episodic backdrops. Switch this on only if you want backdrop and thumbnail to share the still.

Thumbnail Ratings

Episode thumbs only support TMDB and IMDb today.

Preset mapping

Poster: tmdb:{type}:{tmdb_id}

Background: tmdb:{type}:{tmdb_id}

Logo: tmdb:{type}:{tmdb_id}

Episode thumb: {imdb_id}, {season}, {episode}

Thumbnail episode artwork: still

Backdrop episode artwork: series

Thumbnail ratings: tmdb,imdb

XRDB settings

Use the configurator for keys, language, ratings, layout, badges, and text.

A plain addon manifest URL will not apply the settings configured here by itself. Use the generated XRDB proxy manifest below if those settings should drive addon artwork.

Export

Generated Manifest

Use this URL in Stremio. It ends with manifest.json and has no query params.

https://xrdb.example.com/proxy/{config}/manifest.json
Open

Add manifest URL, TMDB key and MDBList key to generate a valid link.

Route addon artwork through XRDB
Proxy routes `meta.poster`, `meta.background`, and `meta.logo` through XRDB for both `catalog` and `meta` responses using the active configurator settings above.
Artwork
TMDB
Text
Clean
Badge mode
Both
Output
Poster
Presentation
Standard
Style
Pill Glass

What is IbbyLabs Uptime Tracker?

It is the IbbyLabs public status board for popular Stremio addons, including current health and incident updates.