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.
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.
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 |
| 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 |
| 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 |
Type Configs
| Type | Config | Layouts / Values |
|---|---|---|
| poster | imageText posterRatingsLayout posterQualityBadgesPosition posterRatingsMaxPerSide posterQualityBadgesMax | original, clean, alternative 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 backdropRatingsLayout backdropQualityBadgesMax | original, clean, alternative center, right, right vertical 1+ (auto if omitted) |
| logo | logoRatingsMax logoBackground | 1+ (auto if omitted) transparent, dark |
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