Repository navigation
Releases
v1.2.0
- Each Kodi installation is its own device in the TOP Posters dashboard, with its own settings. The add-on creates an installation ID on first run and adds it to every artwork URL.
- Kodi's own user agent names the platform (Android TV, Fire TV, Windows, macOS, LibreELEC…).
- Advanced settings: Use a new installation ID, for a Kodi data folder copied to another box.
Install: download service.topposters-1.2.0.zip and use Settings → Add-ons → Install from zip file. Installing over 1.1.0 keeps your settings.
v1.1.0
Local artwork stored on the Kodi device or a network share is now replaced only after a TOP Posters image has downloaded successfully. Failed downloads keep the original artwork or the last good downloaded replacement.
- Refresh downloaded replacements on the configured schedule or with Refresh ratings now.
- Revalidate unchanged images with conditional requests and pause retries after connection failures, authentication errors, rate limits and server errors.
- Preserve Restore original artwork and keep local original paths off the API.
- Keep season-zero handling unchanged.
Local replacements download during application and refresh, using API requests. Online originals retain their existing on-demand loading behavior.
Requires Kodi 19 (Matrix) or later. All 55 automated tests passed and the installable ZIP was verified against the source. Installation and artwork rendering still need verification on a real Kodi device.
v1.0.0
First release of the TOP Posters add-on for Kodi 19 (Matrix) and later.
Install: download service.topposters-1.0.0.zip below, then in Kodi go to Settings → Add-ons → Install from zip file. Open the add-on settings, enter your TOP Posters API key and press Check API key.
- Posters and season posters with rating badges, plus episode thumbnails, landscape banners, backgrounds and logos depending on your plan
- Works with any scraper; titles matched by TMDB, IMDb or TVDB ID
- Original artwork kept as fallback and restorable at any time
- Ratings refreshed on a schedule (every 7 days by default)