IGDB Catalog — MyHomeGames

MyHomeGames uses the IGDB API (via Twitch Developer Services) for personal catalog enrichment only. You need Twitch application credentials (Client ID and Client Secret). This is not a Twitch user login — no sign-in with a Twitch account is required.

Automatic setup (recommended)

If you use the hosted Cloudflare Tunnel and API gateway, IGDB credentials are injected automatically on /igdb/* requests. You do not register your own Twitch app and you do not enter Client ID or Secret in the web app.

Connect the tunnel from Settings → Cloudflare profile.
Open Settings → IGDB / Twitch and enable IGDB API.

Credentials are stored on the API gateway (Cloudflare Worker), not in your browser or in server settings. See the myhomegames-proxy repository for details.

Manual setup (self-hosted, no proxy)

Choose this path if you run the server locally (or without the Cloudflare IGDB proxy) and want to use your own Twitch application credentials.

1. Register a Twitch application

Sign in to the Twitch Developer Console (create a Twitch account first if needed).
Click Register Your Application.
Use a name such as MyHomeGames, category Application Integration.
OAuth redirect URLs are not used for IGDB catalog search. If the form requires a URL, you can use a placeholder such as http://localhost.
Copy the Client ID, then under Manage → New Secret generate a Client Secret and store it safely.

Open Twitch Developer Console

2. Configure MyHomeGames

Enter the credentials in one of these places:

Method	Where
Web UI (recommended)	Settings → IGDB / Twitch — enable IGDB API, enter Client ID and Client Secret
Server `.env`	`TWITCH_CLIENT_ID` and `TWITCH_CLIENT_SECRET`

The Settings page shows Client ID / Secret fields only when the app is not in Cloudflare Tunnel mode (VITE_CLOUDFLARE_TUNNEL_ENABLED is not set for production builds that rely on the gateway).

3. Enable IGDB in the app

In Settings → IGDB / Twitch, turn on Enable IGDB API (or Enable Client ID / Secret (IGDB) when configuring credentials locally).

Troubleshooting

Credentials not available (tunnel): check Worker secrets and that IGDB is enabled in Settings.
Credentials not available (local): check Client ID / Secret in Settings or .env.
No credential fields in Settings: the app expects the gateway to inject credentials — use manual setup only without tunnel mode.

Full technical reference: IGDB.md in the server repository.