Game search (IGDB)

When players pick the games they play, Auto Tournament can search a game catalogue and show covers and names pulled from IGDB. Without any keys, search still works using a built-in list of installed game modules and popular esports titles — IGDB just adds a much wider catalogue with cover art.

Is it free?

Yes, for non-commercial use, under the Twitch Developer Service Agreement. See IGDB's account creation page for details. If you're using IGDB commercially, IGDB offers a separate partnership — see the same page.

Create a Twitch account with 2FA

IGDB authenticates through Twitch. You need a Twitch account with Two-Factor Authentication enabled.

Register an application

Go to the Twitch Developer Console and register a new application.
For OAuth Redirect URLs, enter http://localhost. IGDB doesn't use this value, but Twitch requires one.
Set Client Type to Confidential.

Copy the Client ID and Client Secret

On the application's page, click Manage.
Copy the Client ID.
Click New Secret and copy the Client Secret. Twitch shows it only once.

Add the keys in Settings

Open Settings in Auto Tournament.
Find the IGDB card.
Paste the Client ID and Client Secret, then click Save.
Click Test connection to confirm the keys work.

Using environment variables instead

If you'd rather set the keys through your deployment's environment, use:

.env

IGDB_CLIENT_ID=your-igdb-client-id
IGDB_CLIENT_SECRET=your-igdb-client-secret

Environment variables take priority over the values saved in Settings.

Troubleshooting

Test connection fails:

Generate a new Client Secret in the Twitch Developer Console and save it again.
Check that the application's Client Type is set to Confidential.
Check that the server running Auto Tournament can reach id.twitch.tv and api.igdb.com.

IGDB's rate limit is 4 requests per second. Auto Tournament caches searches, so normal use stays far below that.