sync

Trakt.tv Integration

Last updated: August 2026

What Is Trakt?

Trakt automatically tracks TV shows and movies you watch across all your apps and devices. Aerial TV integrates with Trakt so you can sync your watch history, get personalized recommendations, manage your watchlist, and see community ratings—all connected to your Trakt.tv account.

  • Two-way watch history sync — Watched movies and episodes sync between Aerial TV and Trakt.
  • Live scrobbling — Your progress is sent to Trakt in real-time as you watch.
  • Calendar — A dedicated Calendar tab shows upcoming episode premieres for shows you track.
  • Watchlist & recommendations — Items from your Trakt watchlist and personalized recommendations appear in Aerial TV, matched to your local library.
  • Community ratings — Trakt community ratings are shown on movie and series detail screens.
lightbulb
Tip: You need a free Trakt.tv account. Create one at trakt.tv if you do not have one yet.

Connecting Your Trakt Account

Aerial TV uses Trakt's device authentication flow. You connect by entering a short code on the Trakt website.

  1. 1Open the Settings tab in Aerial TV.
  2. 2Scroll to the Trakt section and tap "Connect with Trakt."
  3. 3A sheet appears with your activation code (e.g. ABCD-1234) and a button to open Trakt.tv.
  4. 4On Mobile Devices: Tap "Open Trakt.tv" — the code is copied to your clipboard and your browser opens. Sign in to Trakt (if needed) and enter the code when prompted.
  5. 5On Smart TVs: On another device (phone or computer), go to the URL shown on screen, sign in to Trakt, and enter the code displayed on your TV.
  6. 6After you authorize the app on Trakt, Aerial TV automatically completes the connection. You will see "Connected to Trakt.tv" with your username.
warning
Warning: The activation code expires after 10 minutes. If it expires, cancel and start again to get a new code.

Trakt Settings

Once connected, you can control how Aerial TV uses your Trakt account.

  • Auto-scrobble while watching — When enabled, your playback progress is sent to Trakt in real-time. Disable this if you prefer not to report what you are watching.
  • Sync watch history — When enabled, Aerial TV syncs your watched movies and episodes with Trakt. This runs automatically in the background and can also be triggered manually.
  • Sync Now — Tap to manually sync your watch history with Trakt right away.

Calendar, Watchlist & Recommendations

When Trakt is connected, a new Calendar tab appears in the main navigation. This shows you exactly when new episodes of your tracked shows are airing, making it easy to stay caught up. Additionally, if you have items in your Trakt watchlist or receive recommendations from Trakt, Aerial TV shows them on the Home screen. Items are matched to your local library—you only see movies and shows that exist in your playlists or media servers.

info
Note: The Calendar, Watchlist, and recommendation rows only appear when you have Trakt connected and there are matching items in your library.

Disconnecting Trakt

To stop syncing with Trakt, go to Settings > Integrations > Trakt (Android) or Settings > Trakt (iOS) and tap "Disconnect Trakt Account." Your data remains on Trakt.tv, but Aerial TV will no longer sync. You can reconnect at any time.