PLAXT
Get Started

Trakt Setup

Connect your Trakt account to receive watch history from your media servers and streaming services.

What is Trakt?

Trakt is a platform that keeps track of the TV shows and movies you watch. It integrates with many apps and services to automatically log your viewing history, provide recommendations, and let you discover new content.

Prerequisites

  • A Trakt account (sign up free)
  • Trakt VIP is not required for basic scrobbling (VIP unlocks extra Trakt features)

Connecting Trakt

  1. Go to Connections in the Plaxt dashboard
  2. Click Connect Trakt
  3. You’ll be redirected to Trakt to authorize
  4. Click Yes to grant Plaxt access
  5. You’ll be redirected back to Plaxt

Your Trakt account is now connected and ready to receive scrobbles.

What Gets Synced

When connected to a source, Plaxt syncs:

  • Movies — Title, year, watched timestamp
  • TV Episodes — Show, season, episode, watched timestamp
  • Watch status — Marks items as watched on Trakt

Scrobbling Behavior

Plaxt follows Trakt’s scrobbling protocol:

  1. Start — When you begin watching (shows as “watching now”)
  2. Pause — When you pause playback
  3. Stop — When you finish or stop watching (marks as watched if >80% complete)

This means your friends can see what you’re currently watching on your Trakt profile.

To start syncing to Trakt:

  1. Go to Dashboard → Create Sync Link
  2. Select your source (e.g., Plex)
  3. Select your Trakt connection as the destination
  4. Choose which user to sync (if applicable)
  5. Configure options (movies, TV shows)
  6. Click Create

History Sync

Sync your existing watch history:

  1. Open your sync link
  2. Click Sync History
  3. Plaxt will fetch history from your source and mark items as watched on Trakt

Note: This won’t create duplicate entries—Trakt handles deduplication automatically.

Multi-Account Support

If you have multiple Trakt accounts:

  1. Connect each Trakt account separately
  2. Create different sync links for each account
  3. Map different source users to different Trakt accounts

Privacy Settings

Control what’s shared on Trakt:

  1. Go to Trakt Settings
  2. Adjust privacy options for your watching activity
  3. Plaxt respects your Trakt privacy settings

Troubleshooting

Authorization failed

  1. Make sure you clicked “Yes” on the Trakt authorization page
  2. Try disconnecting and reconnecting
  3. Clear your browser cookies and try again

Scrobbles not appearing

  1. Check the event log in your sync link
  2. Verify the source is properly connected
  3. Ensure you watched past the 80% threshold

Duplicate entries

  1. Trakt automatically deduplicates—duplicates are rare
  2. If you see duplicates, check if you have multiple sync links to the same Trakt account
  3. Contact support if the issue persists

Trakt Features

Once connected, you can use Trakt features like:

  • Calendar — See upcoming episodes for shows you watch
  • Progress — Track your progress through TV series
  • Recommendations — Get suggestions based on your history
  • Lists — Organize your watchlist and collections
  • Stats — View your watching statistics

Best Practices

  • Keep your Trakt account connected for automatic scrobbling
  • Use history sync to backfill older watch history
  • Check Trakt’s calendar for upcoming episodes of your shows
Back to Docs Edit on GitHub