Skip to content
aioratings aioratings

Jellyfin

aioratings posters are plain image URLs, so the supported path today is the folder-agent / local-image flow. A native Jellyfin plugin is planned.

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: folder-agent / local images

Section titled “Today: folder-agent / local images”

Jellyfin reads sidecar images from each item’s folder. To use aioratings posters:

  1. For each item, fetch its aioratings poster and write it into the item’s media folder as a local primary image — e.g. poster.jpg (or folder.jpg) next to the movie file, and poster.jpg in the series folder for TV.
  2. In Jellyfin, set the library to prefer/allow local images (Dashboard → Libraries → (your library) → Manage Library → Metadata: keep image fetchers from overwriting, and rescan).
  3. Rescan / refresh metadata so Jellyfin picks up the local poster.jpg.

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

Later: native plugin (planned)

Section titled “Later: native plugin (planned)”

A native Jellyfin plugin that fetches aioratings posters directly (no file juggling) is on the roadmap. It is not available yet — use the folder-agent flow above for now.