Stunning Ratings.
Stateless API.
Forked by IbbyLabs for the same ecosystem as Uptime Tracker. Generate dynamic posters, backdrops, and logos with a cleaner config to output workflow.
Checking the latest release on GitHub now.
Need help with ERDB, ratings, or the addon proxy?
If you hit a rendering issue, need help with badges or language, or want a hand wiring this project into your setup, message me on Discord.
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.
Inputs
Configurator
Adjust parameters once. The config string, live preview, and addon proxy export all reuse this same ERDB setup.
Save the shared ERDB 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.
This mode still respects the selected layout below, so you can move ratings to top, bottom, left, or right.
Genre badges use a small curated bucket set. Clear genres such as horror, comedy, sci fi, fantasy, crime, documentary, and anime resolve; fuzzy cases stay off.
ERDB respects this order when rendering badges. Disabled providers stay available but are skipped.
Export
ERDB Config String
Base64url string containing API keys and all settings. Base URL is detected automatically from the current domain.
Use this when another tool expects one ERDB config field. The settings travel inside this string, not inside your saved workspace by itself.
Add TMDB key and MDBList key to generate a valid config string.
Output
Preview Output
Stateless dynamic layout generated via query parameters.
Curated movie, show, and anime renders that keep the badge decision fixed while you compare text, icon, and combined modes.
Proxy
Addon Proxy
Paste a Stremio addon manifest here. The generated ERDB proxy manifest carries the configurator values from this workspace as its ERDB source of truth.
Use the configurator for keys, language, ratings, layout, badges, and text.
A plain addon manifest URL will not pick up saved workspace values by itself. Use the generated ERDB proxy manifest below if you want those settings applied to addon artwork.
Export
Generated Manifest
Use this URL in Stremio. It ends with manifest.json and has no query params.
Add manifest URL, TMDB key and MDBList key to generate a valid link.
Developers
Reference surfaces with clearer grouping
The docs area now follows the same section rhythm as the rest of the page, with feature summaries first and the heavier tables and prompt content grouped underneath.
Dynamic Rendering
No tokens needed. Pass parameters in the query string and let ERDB handle metadata and rendering.
Addon Friendly
Perfect for Stremio, Kodi or any media center addon. Use simple URL patterns for easy integration in your code.
API Reference
| Parameter | Values | Default |
|---|---|---|
| type (path) | poster, backdrop, logo | none |
| id (path) | IMDb, TMDB, Kitsu, etc. | none |
| ratings | tmdb, mdblist, imdb, tomatoes, tomatoesaudience, letterboxd, metacritic, metacriticuser, trakt, rogerebert, myanimelist, anilist, kitsu (global fallback) | all |
| posterRatings | tmdb, mdblist, imdb, tomatoes, tomatoesaudience, letterboxd, metacritic, metacriticuser, trakt, rogerebert, myanimelist, anilist, kitsu (poster only) | all |
| backdropRatings | tmdb, mdblist, imdb, tomatoes, tomatoesaudience, letterboxd, metacritic, metacriticuser, trakt, rogerebert, myanimelist, anilist, kitsu (backdrop only) | all |
| logoRatings | tmdb, mdblist, imdb, tomatoes, tomatoesaudience, letterboxd, metacritic, metacriticuser, trakt, 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 genre badge) | off |
| 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 |
| qualityBadgesStyle | glass, square, plain (global fallback) | glass |
| posterQualityBadgesStyle | glass, square, plain (poster only) | glass |
| backdropQualityBadgesStyle | glass, square, plain (backdrop only) | glass |
| posterQualityBadgesMax | 1+ | auto |
| backdropQualityBadgesMax | 1+ | auto |
| ratingPresentation | standard, minimal, average, blockbuster | standard |
| aggregateRatingSource | overall, critics, audience | overall |
| ratingStyle | glass, square, plain | glass (poster/backdrop), plain (logo) |
| imageText | original, clean, alternative | original (poster), clean (backdrop) |
| posterRatingsLayout | top, bottom, left, right, top bottom, left right | top bottom |
| posterRatingsMaxPerSide | 1+ | auto |
| backdropRatingsLayout | center, right, right vertical | center |
| logoRatingsMax | 1+ | auto |
| logoBackground | transparent, dark | transparent |
| tmdbKey (req) | TMDB v3 API Key | none |
| mdblistKey (req) | MDBList.com API Key | none |
Genre badges use a small curated family set. Strong buckets such as horror, comedy, sci fi, fantasy, crime, documentary, and anime resolve; ambiguous combinations stay off.
Transparent provider icons stay transparent across glass, square, and plain. In glass, icons with transparency such as Kitsu render on a neutral inner chip with an accent ring so the accent color does not bleed through the icon cutouts.
Type Configs
| Type | Config | Layouts / Values |
|---|---|---|
| poster | imageText posterRatingPresentation posterAggregateRatingSource posterRatingsLayout posterQualityBadgesPosition posterRatingsMaxPerSide posterQualityBadgesMax | original, clean, alternative standard, minimal, average, blockbuster overall, critics, audience top, bottom, left, right, top bottom, left right auto, left, right (top or bottom layouts only) 1+ (auto if omitted) 1+ (auto if omitted) |
| backdrop | imageText backdropRatingPresentation backdropAggregateRatingSource backdropRatingsLayout backdropQualityBadgesMax | original, clean, alternative standard, minimal, average, blockbuster overall, critics, audience center, right, right vertical 1+ (auto if omitted) |
| logo | logoRatingsMax logoBackground logoRatingPresentation logoAggregateRatingSource | 1+ (auto if omitted) transparent, dark standard, minimal, average, blockbuster overall, critics, audience |
ID Formats
| Source | Format | Example |
|---|---|---|
| IMDb | tt + numbers | tt0133093 |
| TMDB | tmdb:id or tmdb:movie:id or tmdb:tv:id | tmdb:movie:603, tmdb:tv:1399 |
| Kitsu | kitsu:id | kitsu:1 |
| Anime | provider:id | anilist:123, mal:456 |
Base Structure
AI Developer Prompt
Copy this prompt to help an AI agent implement this API in your addon.
Live Examples
Movie Poster (IMDb)http://localhost:3000/poster/tt0133093.jpg?ratings=imdb,tmdb&ratingStyle=plainBackdrop (TMDB)http://localhost:3000/backdrop/tmdb:movie:603.jpg?ratings=mdblist&backdropRatingsLayout=right%20vertical