Skip to main content

Source Specific Options

The Collection Type and Collection Sub-Type dropdowns decide which external list Agregarr uses for the collection. Each selection unlocks different inputs, and certain sources require API keys (set in Settings -> Sources).

Source Summaries

Overseerr Requests

  • Individual Users – builds a collection per Overseerr user (except the server owner) and restricts visibility to the library tab only (because Plex ignores label restrictions on the home screen).
  • Server Owner – builds a collection based on the server owner’s requests and has the option to show the collection on the owner’s home screen.
  • Global – aggregates all Overseerr requests into a single collection.

Tautulli Statistics

  • Choose between Most Popular (by Play Count) or Most Popular (by Watch Duration).
  • Supply a Number of Days window and a Minimum Play Count so you can ensure the collection has a decent number of items.

Trakt Lists

Sub-typeDescriptionExtra Input
TrendingWhat users are watching right now
PopularHighest-rated items on Trakt
PlayedMost plays over a periodTime period selector
WatchedUnique watchers over a periodTime period selector
CollectedMost collected itemsTime period selector
FavoritedMost favourited itemsTime period selector
Custom ListImport any public Trakt listURL validation
Random ListsFind a new random list each syncSet custom random lists in config/random-lists

TMDB Lists

Sub-typeDescriptionExtra Input
Trending TodayDaily trending feed
Trending This WeekWeekly trending feed
PopularPopular items by TMDB votes
Top RatedHighest-rated TMDB entries
Custom Collection/ListImport a TMDB collection or listURL validation
Random ListsFind a new random list each syncSet custom random lists in config/random-lists

IMDb Lists

Sub-typeDescriptionExtra Input
Top 250IMDb Top 250 movies or shows
Popular (Meter)Daily popularity rankings
Custom ListImport any public IMDb listURL validation
Random ListsFind a new random list each syncSet custom random lists in config/random-lists

Letterboxd Lists

Sub-typeDescriptionExtra Input
Custom ListFollow a Letterboxd user or listURL validation
Random ListsFind a new random list each syncSet custom random lists in config/random-lists

MDBList

Sub-typeDescription
Custom ListUse an MDBList list

AniList

Sub-typeDescription
TrendingCurrent trending anime
PopularMost popular anime overall
Top RatedHighest-rated anime
Custom ListImport an AniList user list

MyAnimeList

Sub-typeDescription
Top Anime SeriesOverall top-rated anime
Top AiringCurrently airing rankings
Top TVTV-only rankings
Top MoviesMovie rankings
Top OVAOriginal video animation rankings
Top SpecialsSpecial releases
Most PopularOrdered by member count
Most FavoritedOrdered by user favourites

Networks Top 10

  • Pick a Country/Region to filter the available streaming charts.
  • Choose a Platform from the dynamic list that loads for the selected country.

Network Originals (uses MDBList - API key required)

  • Select the provider whose originals you want to use. These are true originals, not just items that appear on the streaming service.

Radarr / Sonarr Tags

  • Pick the Radarr or Sonarr instance, then choose the tag to use.
  • The tag dropdown only populates after an instance is selected.

Coming Soon

  • Monitored in Radarr/Sonarr keeps an eye on monitored titles that have not been released yet so you can show upcoming media you already plan to download.
  • Trakt Anticipated mirrors Trakt’s anticipated feed for movies or shows, shows a banner overlay and uploads a trailer if available or a placeholder if not.

Multi-Source Collections

  • Enable Multiple Sources to aggregate sources
  • The mixed-content warning restricts combine mode choices when you mix incompatible media types, for example TV Shows and Individual Episodes cannot be in the same collection.

Combine Modes

ModeBehaviour
List OrderAll items from source 1, then all from source 2, etc.
InterleavedTake 1st item from each source, then 2nd from each, etc.
RandomisedShuffle all items randomly on every sync
Cycle ListsOnly one source active at a time, rotates each sync

Custom URL Validation

Custom sub-types across Trakt, TMDB, IMDb, Letterboxd, MDBList, and AniList require a URL before the rest of the form unlocks. Use the Validate button to pull the title from the source and confirm that the link is reachable.