docs/romm/Generate-API-Keys.md

SteamGridDB

To access the SteamGridDB API, create an account by linking your Steam account, and head to your API Preferences page. Copy (or generate) the API key and use it to set STEAMGRIDDB_API_KEY.

Mobygames

To access the Mobygames API, create a MobyGames account and then visit your profile page. Click the 'API' link under your user name to sign up for an API key. Copy the key shown and use it to set MOBYGAMES_API_KEY.

IGDB

To access the IGDB API you'll need a Twitch account and a valid phone number for 2FA verification. Up-to-date instructions are available in the IGDB API documentation. When registering your application in the Twitch Developer Portal, fill out the form like so:

• Name: Something unique or random like correct-horse-battery-staple or KVV8NDXMSRFJ2MRNPNRSL7GQT
• OAuth Redirect URLs: localhost
• Category: Application Integration
• Client Type: Confidential

Important

The name you pick has to be unique! Picking an existing name will fail silently, with no error messages. We recommend using romm-<random hash>, like romm-3fca6fd7f94dea4a05d029f654c0c44b

Note the client ID and secret that appear on screen, and use them to set IGDB_CLIENT_ID and IGDB_CLIENT_SECRET in your environment variables.

SteamGridDB

To access steamGridDB API, you need to login into their website with a steam account. Once logged in, go to your API tab under the preferences page. Copy the key shown and use it to set STEAMGRIDDB_API_KEY.