IGDB Import

IGDB List Import

Bring a list you keep on IGDB.com - a wishlist, a "played" list, any custom list - into Tonkatsu Box as a collection.

What gets imported

IGDB data	Tonkatsu Box
Every game on the list	Games matched by their IGDB id
Games IGDB no longer has	Added to Wishlist under an IGDB-<date> tag

The export carries no personal data - no statuses, no ratings - so you pick one status and one platform for the whole file during import.

Requirements

• IGDB API key - the import talks to IGDB to fetch full game data. Set up IGDB
• A CSV export of your list - on IGDB.com open the list and use its export option; you get a .csv file.

How to import

1. Go to Settings → Import → Import IGDB List
2. Press Select CSV file and pick the exported file
3. Pick a status for imported games - or leave it unset to keep the default
4. Pick the platform from the searchable list - required, it's the platform every imported game gets
5. Choose target collection:
   • Create new collection
   • Use existing collection - select from dropdown
6. Tap Start Import

How matching works

Every row of the export carries the IGDB game id, so there's no guessing by name: games are looked up by id directly. That makes this the most reliable game import - a match is either exact or the game is gone from IGDB entirely. Removed games land in your Wishlist with the list's tag so you can deal with them later.

Re-importing

Importing the same file again is safe:

• Games already in the collection are not duplicated.
• If you left the status unset, existing items keep whatever status you gave them.
• If you picked a status, it only moves items forward (e.g. Not Started → In Progress) and never downgrades a Completed or Dropped you set yourself.

Tips

• If the IGDB connection is not set up, the import screen says so at the top - add the keys first.
• One list = one platform. If your list mixes platforms, import it in parts or fix platforms afterwards per item.