Kometa

Kometa can pull aioratings posters in two ways. Pick the one that matches what you want.

aioratings poster URL:

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

{idType} = imdb, tmdb or tvdb
poster-default = the built-in style, or a custom profile (premium/pro)
{id} = tt… (imdb), movie-{id} / tv-{id} (tmdb), or a TVDB numeric id

See URL shape & idTypes for the full rules.

Option A — replace your poster source (recommended)

Use aioratings as your poster URL source so Kometa downloads the rated poster and sets it as the item’s poster.

`mass_poster_url`

In a library’s operations: block, point the mass poster operation at the aioratings URL template:

libraries:
  Movies:
    operations:
      mass_poster_url: https://api.aioratings.com/YOUR_KEY/imdb/poster-default/<imdb_id>.jpg

Use Kometa’s id placeholders so it substitutes each item’s IMDb id. Check the current Kometa docs for the exact placeholder token your version expects.

`url_poster` per item

If you manage posters per item, set the aioratings URL as a poster override in a collection/overlay/metadata file’s url_poster:

url_poster: https://api.aioratings.com/YOUR_KEY/tmdb/poster-default/movie-1396.jpg

Option B — folder-agent / local assets path

If you would rather aioratings produce the image files and let Plex/Kometa pick them up as local assets, run the folder-agent flow: write the aioratings poster for each item into that item’s media folder as poster.jpg, and have your server “use local assets”. aioratings becomes the source of the poster.jpg; Kometa/Plex never calls the network for it.

This is the same folder-agent pattern used for Plex, Jellyfin and Emby — see those pages for the asset filename/placement details per server.