Repository navigation
Steam Import
Import your Steam game library into Tonkatsu Box. Games are matched against the IGDB database, with playtime and status tracking.
| Steam data | Tonkatsu Box |
|---|---|
| Owned games | Games matched to IGDB |
| Playtime | Saved as user comment ("Steam: 2.1h") |
| Last played date | Saved as Last activity date |
| Games with playtime > 0 | Status "In Progress" |
| Unplayed games | Status "Not Started" |
| Unmatched games | Added to Wishlist |
| DLC, soundtracks, demos | Filtered out automatically |
- IGDB API key - needed to match Steam games to the IGDB database. Set up IGDB
- Steam Web API key - get one for free at steamcommunity.com/dev/apikey
- Steam ID (64-bit) - find yours at steamidfinder.com
- Public Steam profile - your game library must be visible
- In Tonkatsu Box: go to Settings → Import → Steam Library
- Enter your Steam API Key
- Enter your Steam ID (64-bit)
- (Optional) Tick Remember credentials to save the API key and Steam ID locally - next time the form opens prefilled. Unchecking and starting an import wipes the saved pair.
- Choose target collection:
- Create new collection - creates "Steam Library"
- Use existing collection - select from dropdown
- Tap Import
During import you'll see:
- Current stage (fetching library, matching games)
- Progress bar with current / total count
- Name of the game being matched
- Live counters: imported, added to wishlist, updated
For each game in your Steam library:
- The app searches IGDB by the game's name
- It picks the best match: exact name > substring match > first result
- If found - the game is added to the collection with PC platform
- If not found - the game is saved to your Wishlist with a media type hint
When importing into an existing collection:
- Games already in the collection are updated (not skipped):
- Playtime comment is refreshed with the latest data
- Last activity date is updated from Steam's "last played"
- Status is upgraded only from Not Started → In Progress (never downgrades Completed or Dropped)
- Wishlist entries are deduplicated - existing unresolved items with the same name are not duplicated
IGDB has a limit of 4 requests per second. The importer automatically adds delays to stay within the limit. A library of 200 games takes about 1-2 minutes.
- You can re-import to update playtime data - existing items will be updated, not duplicated
- Games filtered as DLC/soundtracks/demos won't appear - this is automatic based on the game name
- If IGDB connection is not set up, a warning appears at the top of the import screen