# PlexyTrack

[PlexyTrack](<https://github.com/Drakonis96/plexytrack>), developed by [Drakonis96](<https://github.com/Drakonis96>), is a two-way sync between [Plex](</app/plex/>) and [Trakt.tv](<https://trakt.tv>) or [Simkl](<https://simkl.com>). It mirrors watch history, ratings, watchlists, and collections in both directions, on a configurable sync interval.

**When does managed PlexyTrack make sense?**

- **Trakt power user with Plex**: keep Trakt's social-watching features and richer history alongside the Plex library you actually stream from.
- **Migrating watch history** between Plex and Trakt (*in either direction*).
- **Syncing curated lists**: Trakt lists you like become Plex collections, and Plex collections you build appear as Trakt lists.
- **Always-on sync.** PlexyTrack at home risks missing updates if your hardware sleeps; ElfHosted's instance runs continuously, syncing on whatever interval you set (*60+ minutes recommended*).

A built-in Flask UI lets you toggle features and trigger backups of your history, watchlist, and ratings.

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

## How do I access PlexyTrack?

PlexyTrack is available:

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

> [!NOTE]
>
> **Info**
>
> PlexyTrack is an open-source tool. ElfHosted provides hosting infrastructure only. Users are responsible for their use of this service in compliance with applicable laws and third-party terms of service.

## How to use PlexyTrack

Use [ElfBot](<https://docs-internal.elfhosted.com/app/elfbot/>) to set **one set** of the following ENV vars, depending on which provider you want to sync with:

### Trakt

- `TRAKT_CLIENT_ID`
- `TRAKT_CLIENT_SECRET`

### Simkl

- `SIMKL_CLIENT_ID`
- `SIMKL_CLIENT_SECRET`

## PlexyTrack also works with

- [x] [Plex](</app/plex/>)

## How do I get support for PlexyTrack?

1. For general use of PlexyTrack, refer to the [official site](<https://github.com/Drakonis96/plexytrack>) 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/>)!

## PlexyTrack resources

- [PlexyTrack (*official site*)](<https://github.com/Drakonis96/plexytrack>)
- [PlexyTrack Documentation](<https://github.com/Drakonis96/plexytrack#readme>)
