Repository navigation
Trakt Import
Import your watch history, ratings, and watchlist from Trakt.tv into Tonkatsu Box.
| Trakt data | Tonkatsu Box |
|---|---|
| Watched movies | Movies with status "Completed" |
| Watched shows | TV Shows with status "Completed" or "In Progress" |
| Ratings (1-10) | User rating |
| Watchlist | Items with status "Planned" |
| Episode progress | Individual watched episodes tracked |
| Animated content | Auto-detected as Anime |
- Go to trakt.tv and log in
- Go to Settings → scroll down to Export
- Click Export → download the ZIP file
- Save it to your device
- In Tonkatsu Box: go to Settings → Import → Trakt Import
- Tap Select file and choose the downloaded
.zip
-
Configure import options:
- Import watched - your watch history (movies and shows)
- Import ratings - your 1-10 ratings
- Import watchlist - your "want to watch" list
- Create new collection or add to an existing one
-
Tap Import
-
The app processes the file, matches items against TMDB, and adds them to your collection
During import you'll see:
- Current stage (reading file, fetching data, adding items)
- Progress bar
- Items imported / skipped / added to wishlist
The importer automatically detects animated content. Movies and shows tagged with the Animation genre in TMDB are categorized as Anime in Tonkatsu Box.
If a movie or show from your Trakt history can't be matched in TMDB, it's saved to your Wishlist with the title and media type - so nothing is lost. You can search and add it manually later.
- A TMDB API key (or use the built-in key) - needed to fetch movie/show details
- The Trakt export ZIP file
💡 No Trakt API key is needed - the import works directly from the exported ZIP file.
- Large libraries (1000+ items) may take a few minutes to import - the app needs to fetch details from TMDB for each item
- You can re-import - duplicates are detected and updated (status, ratings, dates) instead of skipped
- Episode progress is preserved - if you watched seasons 1-3 of a show, the tracker will reflect that