# Agregarr

Agregarr is a collections manager for [Plex](</app/plex/>). It builds collections from lists (*your own lists on Trakt, Letterboxd, IMDb, TMDB, MDBList, AniList or MyAnimeList, plus collections generated from your [Tautulli](</app/tautulli/>) watch statistics*), refreshes them on a schedule, and lets you decide where each one sits on the Home, Recommended and Library tabs. Rows can be limited to certain days or hours, so a row of cartoons only shows up at the weekend, and the Home screen order can rotate so Plex doesn't look the same every time you open it.

It's a web UI rather than a config file, which is the main difference from [Kometa](</app/kometa/>): Agregarr only does collections, Kometa does collections plus metadata and overlays, and the two can run side by side (*leave overlays to one of them*).

**When does hosted Agregarr make sense?**

- **Collections refresh while you're not looking.** Agregarr syncs every 12 hours by default, or on whatever schedule you set per collection. On ElfHosted it's running around the clock, so a row that's meant to appear on Saturday morning does.
- **Your Plex is next door.** If your Plex runs on ElfHosted too, Agregarr talks to it inside your own stack.
- **Behind your ElfHosted login.** The Agregarr site isn't reachable by anyone who can't pass your ElfHosted sign-in.
- **Backed up while it runs.** Agregarr's database is copied every day with SQLite's online backup, which is safe against a running app, so a restore brings back a working Agregarr rather than a half-written file.
- **Updates are done for you,** and ElfHosted is one of the Agregarr developer's [sponsors](</sponsorship/>).

> [!WARNING]
>
> **Plex only, and Plex Pass for the Home screen**
>
> Agregarr works with Plex only, not Jellyfin or Emby. Upstream also notes that putting collections on the Plex **Home** screen needs a **Plex Pass** on the account that owns the server. Without one, Agregarr still builds collections, but they only show on the Library and Collections tabs.

[Get a 7-day trial of ElfHosted Agregarr! 🪄](<https://store.elfhosted.com/product/agregarr/>)

## How do I access Agregarr?

Agregarr is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-agregarr.elfhosted.com](<https://your-username-agregarr.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/agregarr/>) and these become your personal, clickable links.

## How do I use it?

Agregarr sits behind your ElfHosted login, and then asks you to sign in with Plex as well. That second sign-in is how Agregarr gets permission to manage your server's collections.

1. Open Agregarr from your dashboard and click **Sign in with Plex**. Use the Plex account that **owns** the server.
2. Click the refresh icon next to the server dropdown, pick your Plex server, and continue.
3. Add sources. IMDb, TMDB, Letterboxd and AniList lists work with no setup; Trakt, MDBList, MyAnimeList and Tautulli each need a key or address, and each has a **Test** button.
4. Finish setup, then click **Discover**. Agregarr scans your Plex library for the collections and default hubs you already have (*Recently Added, Continue Watching and so on*), so it can order them alongside its own.
5. Create your first collection, preview what it matches in your library, and choose where it appears and when.

If your Plex or Tautulli runs on ElfHosted, these are their addresses inside your stack:

| App | Address |
| --- | --- |
| [Plex](</app/plex/>) | `http://plex:32400` |
| [Tautulli](</app/tautulli/>) | `http://tautulli:8181` |

### Collections from what you already have

Everything above works with titles already in your library: a collection built from a list simply shows the items you have. Agregarr can also hand missing titles to [Radarr](</app/radarr/>), [Sonarr](</app/sonarr/>) or a request tool. That part is optional and off until you configure it; use its preview and filters before you switch it on, so a long list doesn't turn into a long queue.

> [!NOTE]
>
> **Placeholder and 'Coming Soon' collections**
>
> Upstream's placeholder ("Coming Soon") feature writes placeholder files into dedicated folders that Plex also reads. ElfHosted doesn't set those folders up for you, so treat the feature as unsupported and plan around ordinary collections.

## Agregarr also works with

- [x] [Plex](</app/plex/>)
- [x] [Tautulli](</app/tautulli/>)
- [x] [Kometa](</app/kometa/>)

## How do I get support for Agregarr?

1. For general use of Agregarr, refer to the [official site](<https://github.com/agregarr/agregarr>) or to one of the links in the resources section below.
2. For specific support re your ElfHosted configuration / account, see the [ElfHosted support options](</get-help/>)!

## Sponsor Agregarr ❤️

You can contribute directly to the development of Agregarr using the following:

- [Buy Me a Coffee](<https://www.buymeacoffee.com/agregarr>)

## Agregarr resources

- [Agregarr (*official site*)](<https://github.com/agregarr/agregarr>)
- [Agregarr Website](<https://agregarr.org>)
- [Agregarr Documentation](<https://agregarr.org/docs/installation/>)
