Skip to content
aioratings aioratings

Plex

aioratings posters are plain image URLs, so any workflow that can set a Plex item’s poster from a URL or a local file works.

aioratings poster URL:

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

See URL shape & idTypes for the rules ({idType} = imdb / tmdb / tvdb).

Today: folder-agent / “Use local assets”

Section titled “Today: folder-agent / “Use local assets””

Plex has no built-in “RPDB poster provider” setting, so the supported path today is the folder-agent / local-assets flow:

  1. For each item, fetch its aioratings poster and write it into the item’s media folder using Plex’s local-asset poster filename — poster.jpg next to the movie file (or poster.jpg in the show/season folder for TV).
  2. In Plex: Settings → Agents (or the library’s Advanced settings), enable “Use local assets” / “Local Media Assets” for that library.
  3. Refresh metadata. Plex uses the poster.jpg you wrote instead of fetching its own artwork.

Tools that automate this fetch-and-place step include Kometa and the *arr webhook flow. aioratings just provides the image at the URL above.

Later: Custom Metadata Provider (planned)

Section titled “Later: Custom Metadata Provider (planned)”

Plex has signaled support for third-party Custom Metadata Providers, which is how RPDB-style poster providers would plug in directly (no file juggling). When Plex finalizes and ships that spec, aioratings intends to expose a Custom Metadata Provider endpoint so you can add aioratings as a poster source in Plex settings directly.

This is not available yet — it depends on Plex finalizing the provider spec. Until then, use the folder-agent / local-assets flow above.