# List-Sync

List-Sync watches the lists you point it at (*your IMDb, Trakt or Letterboxd watchlist, an AniList planning list, an MDBList list*) and, on a schedule, turns anything new on them into a **request in [Seerr](</app/seerr/>)**. What happens to a request after that is up to your Seerr, exactly as if you'd made it by hand.

It has a web dashboard for adding lists, watching sync runs and seeing what was requested, so there's no config file to edit.

**When does hosted List-Sync make sense?**

- **It runs on schedule, whether you're home or not.** Every 24 hours by default, adjustable.
- **Your Seerr is next door.** If Seerr runs on ElfHosted too, List-Sync talks to it inside your stack.
- **Behind your ElfHosted login.** The dashboard is private to you.
- **Backed up while it runs.** List-Sync's database (*your lists, settings and sync history*) is copied every day with SQLite's online backup, which is safe against a running app.
- **Updates are done for you.**

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

## How do I access List-Sync?

List-Sync is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-listsync.elfhosted.com](<https://your-username-listsync.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/list-sync/>) and these become your personal, clickable links.

## How do I use it?

List-Sync needs a request tool to send to. On ElfHosted that's [Seerr](</app/seerr/>); Overseerr and Jellyseerr, which upstream names, were merged into Seerr.

Open List-Sync from your dashboard. A two-step setup wizard runs the first time.

### Step 1: Connect

The wizard calls this step "Connect to Overseerr"; your Seerr is what it means.

| Field | What to enter |
| --- | --- |
| **URL** | `http://seerr:5055` if your Seerr is on ElfHosted. Replace anything already in the box. |
| **API Key** | From Seerr, under **Settings → General**. |

Then click **Test Connection &amp; Sync Users** and pick the Seerr user that requests are made as.

> [!WARNING]
>
> **Pick the requesting user on purpose**
>
> Your Seerr admin's requests are approved automatically, so if you pick the admin, every new list entry goes straight through. If you'd rather approve each one, create a Seerr user **without** auto-approve permission and pick that user here. Requests then wait in Seerr for you to approve.

### Step 2: Configure

> [!NOTE]
>
> **Everyone needs a Trakt Client ID, even without Trakt lists**
>
> This version of List-Sync won't finish setup without a **Trakt Client ID**. Create an app at [trakt.tv/oauth/applications](<https://trakt.tv/oauth/applications>) (*any name will do*) and copy its **Client ID**, the long string of letters `a` to `f` and numbers. Don't paste the Client Secret or your Trakt username: the wizard checks the ID with Trakt and refuses anything else.

Then set the sync interval (*1 to 168 hours*), whether syncing runs automatically, your timezone, and optionally a Discord webhook for a message after each run.

### Add your lists

From the dashboard, add each list by its URL or ID (*for example your Trakt or IMDb watchlist URL*). Each list shows when it last synced and what it found. The first run on a long list can take a while; later runs only look at what's new.

> [!TIP]
>
> **Start with your own watchlists**
>
> List-Sync can also follow public lists and charts. A list you don't curate yourself can be long and change often, and every new entry becomes a request. Start with the lists you add to yourself, and keep an approval step (above) if you add anything bigger.

## List-Sync also works with

- [x] [Seerr](</app/seerr/>)
- [x] [Pulsarr](</app/pulsarr/>)
- [x] [Listarr](</app/listarr/>)

## How do I get support for List-Sync?

1. For general use of List-Sync, refer to the [official site](<https://github.com/Woahai321/list-sync>) 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/>)!

## List-Sync resources

- [List-Sync (*official site*)](<https://github.com/Woahai321/list-sync>)

> [!NOTE]
>
> **Your content, your responsibility**
>
> ElfHosted provides List-Sync as a hosted application — we do not supply content, accounts, or third-party credentials. You are responsible for ensuring that your use of this app complies with applicable laws and our [Acceptable Use Policy](</legal/acceptable-use/>). If you have questions about what is or isn't permitted, please [reach out](</get-help/>) — we're happy to help.
