Skip to content
aioratings aioratings

Radarr / Sonarr

Radarr and Sonarr do not display posters themselves the way Plex/Stremio do, but they are a convenient place to trigger the folder-agent flow: when a release is imported/upgraded, fetch the aioratings poster for that title and drop it into the media folder as poster.jpg, so your media server (Plex/Jellyfin/Emby/Kodi) picks it up as a local asset.

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. Both Radarr (movies) and Sonarr (series) expose the IMDb, TMDB and TVDB ids of each item, so any idType works. Full rules in URL shape & idTypes.

Folder-agent webhook mode

Section titled “Folder-agent webhook mode”
  1. In Radarr/Sonarr, add a Connect → Custom Script (or Webhook) notification, triggered on On Import and On Upgrade (and optionally On Rename).
  2. In the script, read the title’s id from the environment Radarr/Sonarr passes in:
    • Radarr exposes the movie’s IMDb id / TMDB id (e.g. radarr_movie_imdbid, radarr_movie_tmdbid) and the movie folder path.
    • Sonarr exposes the series’ IMDb id / TVDB id and the series folder path.
  3. Fetch the aioratings poster for that id and write it into the item’s folder as poster.jpg.
  4. Configure your media server to use local assets so it serves that poster.jpg (see Plex, Jellyfin, Emby, Kodi).

Sketch of the script body (bash, Radarr):

Terminal window
# Radarr passes radarr_movie_imdbid and radarr_movie_path on import/upgrade
KEY="YOUR_AIORATINGS_KEY"
IMDB="${radarr_movie_imdbid}"
DEST="${radarr_movie_path}/poster.jpg"
[ -n "$IMDB" ] && curl -fsSL \
  "https://api.aioratings.com/$KEY/imdb/poster-default/$IMDB.jpg" -o "$DEST"

For Sonarr, use the series IMDb id (or its TVDB id with idType=tvdb) and sonarr_series_path:

Terminal window
KEY="YOUR_AIORATINGS_KEY"
IMDB="${sonarr_series_imdbid}"
DEST="${sonarr_series_path}/poster.jpg"
[ -n "$IMDB" ] && curl -fsSL \
  "https://api.aioratings.com/$KEY/imdb/poster-default/$IMDB.jpg" -o "$DEST"