Skip to content
aioratings aioratings

Kodi

aioratings posters are plain image URLs, so the supported path on Kodi today is the local artwork / NFO flow (Kodi’s equivalent of a folder agent).

aioratings poster URL:

https://api.aioratings.com/{key}/{idType}/poster-default/{id}.jpg

{idType} = imdb / tmdb / tvdb; poster-default = the built-in style or a profile; {id} = tt…, movie-{id} / tv-{id}, or a TVDB id. Full rules in URL shape & idTypes.

Today: local artwork

Section titled “Today: local artwork”

Kodi prefers local artwork when present. To use aioratings posters:

  1. For each item, fetch its aioratings poster and place it as Kodi’s local poster artwork in the item’s folder:
    • Movies: <moviefilename>-poster.jpg (or poster.jpg) next to the file.
    • TV shows: poster.jpg in the show folder.
  2. Make sure the scraper / library setting does not overwrite local artwork (Settings → Media → Videos, and the source’s content settings — keep “Local information only” or “Prefer local artwork” as appropriate).
  3. Update the library so Kodi picks up the local poster.

You can also reference the aioratings URL directly in an item’s .nfo file via a <thumb aspect="poster">…</thumb> tag if you generate NFOs:

<thumb aspect="poster">https://api.aioratings.com/YOUR_KEY/imdb/poster-default/tt0903747.jpg</thumb>

Automate the fetch-and-place step with Kometa or the *arr webhook flow; aioratings only serves the image at the URL above.