Sonarr / Radarr

Sonarr and Radarr manage TV and films. This shows what’s coming as posters with the day on them, says if each is already downloaded, and lets the assistant look up the library and start a search.

Set it up

config.yaml

integrations:
  arr:
    type: arr
    sonarr:
      url: http://sonarr:8989
      apiKey: ${SONARR_KEY}
    radarr:
      url: http://radarr:7878
      apiKey: ${RADARR_KEY}
    days: 14
    plex: https://plex.example.com

layout:
  - title: Media
    widgets:
      - arr.upcoming

Option	Type	Default	What it does
sonarr	object	optional	Sonarr, if you use it.
sonarr.url	URL	required	Where the service answers, from Valet’s side.
sonarr.apiKey	string	required	Its API key. Use ${VAR}.
sonarr.href	string	optional	Where the card links to, when that differs from url.
radarr	object	optional	Radarr, if you use it.
radarr.url	URL	required	Where the service answers, from Valet’s side.
radarr.apiKey	string	required	Its API key. Use ${VAR}.
radarr.href	string	optional	Where the card links to, when that differs from url.
days	whole number	14	how far ahead to look (movies: twice that) Range 1 to 90.
plex	URL	optional	Plex’s web address: what’s ready then opens there

Widgets

One widget. Its key is arr.upcoming, using the instance name from your config.

Coming up

arr.upcoming · shelf card · refreshes every 15 minutes while the page is open.

Small

Wide

Medium

Large

In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

States

Nothing scheduled

Can't reach it

Assistant tools

What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.

Tool	Access	What it does
library_lookup	read	Is a show or movie in the library (Sonarr/Radarr), and how complete: episodes downloaded of total, or whether the movie file is there.
library_search	control	Ask Sonarr/Radarr to search now for what’s missing of one show or movie in the library (by title), e.g. when an episode didn’t download.
upcoming_media	read	Episodes airing and movies being released soon for shows and films the person follows (Sonarr/Radarr), and whether each is already downloaded.

Actions

What the page’s own buttons and controls can do. They need a signed-in person or a trusted network.

Action	What it does
search_missing	Search for every missing episode and movie

Year in review

Slides this integration adds to the recap.

Your library grew by 48 titles