Skip to main content

📆 Calendar

The calendar Widget will use Integrations to display upcoming content. It can display content from Sonarr, Radarr, Lidarr and Readarr.

Adding the widget

Please check out our documentation on how to add a widget.

Adding integrations to the widget

Please make sure to select the appropriate integration type for your app, so the calendar widget can communicate with it:

Then, enter your API key and click on the save button:

You can retrieve your API token from the settings pages of your *arr applications.

Using the widget

The calendar widget will display a calendar with indicators for upcoming releases:

Screenshot showing multiple indicators


Homarr will only load the previous, current and next month from your integrations. This means, releases in 2+ / 2- months will not be loaded and visible in the calendar.

Colors of indicators and their meaning

All indicators in the calendar have a specific color depending on their app:

ColorIntegrationProject link
🔴 (red)ReadarrReadarr project link
🟡 (yellow)RadarrRadarr project link
🟢 (green)LidarrLidarr project link
🔵 (blue)SonarrSonarr project link

Release information

All days with indicators will be clickable, highlight the clicked day, and will open a popup with detailed information about the releases on this day:

Screenshot showing pop-up of day information


We have noticed, that the scrollbar is on some devices poorly visible. We'll fix this in a future update of Homarr.

Release Poster

Homarr will load the images from your integration, for example Sonarr. It filters through all images of the release and takes the first match, that is of the cover-type poster.


ConfigurationDescriptionValuesDefault Value
Hide week daysEnable the name of the days on the first row of the calendar (This may cause problems fitting in 2 by 2).yes / noyes
Use Sonarr v4 APIIf you use Sonarr, you may be using Sonarr v4, which uses a different API. If you do use it, then toggle this switch.yes / nono
Use Radarr v5 APISame as for sonarr, if you are running radarr v5, toggle this switch.yes / noyes
Radarr release typeSelect what type of release date to see.
  • Cinemas
  • Physical
  • Digital
In Cinemas
Font SizeSize of the font of the numbers in the calendar. This is to help have a better fit onto bigger sizes (Other than extra small might not be fit for 2 by 2).
  • Extra Small
  • Small
  • Medium
  • Large
  • Extra Large
Extra Small

configuration of the calendar widget


If you come from older versions, or just wondering, the start of the week field is now in the user options so any user can have the format they want. The API fields will also be removed in a future update with API recognition automatization.


Check out our documentation on editing tiles.