API Keys Setup

API Keys Setup

Tonkatsu Box uses free APIs to fetch game and movie data. All keys are free and take a few minutes to set up.

IGDB — for games (recommended)

IGDB is powered by Twitch (Amazon), so you need a Twitch developer account.

Step by step

1. Go to dev.twitch.tv/console and log in (or create a free Twitch account)

2. Click Register Your Application

3. Fill in the form:

   • Name: anything (e.g. "my-tonkatsu")
   • OAuth Redirect URLs: http://localhost
   • Category: Application Integration

4. Click Create

5. Open your new app → copy Client ID

6. Click New Secret → copy Client Secret

7. In Tonkatsu Box: go to Settings → API Keys
8. Paste Client ID and Client Secret into the IGDB section
9. Tap Verify Connection

✅ Done! You now have access to 250,000+ games across 220 platforms.

Troubleshooting

• "Connection error": Double-check that you copied both Client ID and Client Secret correctly, without extra spaces
• "Not connected": Your token may have expired — tap Verify Connection again to refresh it
• Twitch asks for 2FA: You may need to enable Two-Factor Authentication on your Twitch account before creating developer apps

TMDB — for movies, TV shows & anime (recommended)

1. Go to themoviedb.org and create a free account
2. Go to Settings → API in your TMDB profile
3. Click Request an API Key → choose Developer
4. Fill in the form (any info works — personal use is fine)
5. Copy the API Key (v3 auth)
6. In Tonkatsu Box: Settings → API Keys → TMDB section → paste the key

✅ Done! You now have access to movies, TV shows, and anime search.

💡 The app comes with a built-in TMDB key for basic use. Your own key is recommended if you search a lot.

Content language

After setting up TMDB, you can choose the language for movie/show descriptions:

Settings → Content Language → English or Русский

This controls the language of titles, descriptions, and genres from TMDB.

SteamGridDB — for game artwork on boards (optional)

1. Go to steamgriddb.com and create a free account
2. Go to Preferences → API
3. Copy your API Key
4. In Tonkatsu Box: Settings → API Keys → SteamGridDB section → paste

✅ Done! You can now browse and add high-quality game artwork to your canvas boards.

💡 The app comes with a built-in SteamGridDB key. Your own key is optional.

No key needed

These sources work without any API key:

Source	What it provides
VNDB	Visual novels — search, browse by tags, ratings
AniList	Manga — search, browse by genre/format, reading progress (since v0.18.0)
Pre-made collections	.xcollx files with full libraries — fully offline

Summary

Source	What for	Key required?	Time to set up
IGDB	Games (250K+ titles)	Yes (free Twitch token)	~2 min
TMDB	Movies, TV, Anime	Yes (free) or use built-in	~3 min
SteamGridDB	Game artwork for boards	Optional (has built-in)	~1 min
VNDB	Visual novels	No	—
AniList	Manga (since v0.18.0)	No	—