Skip to content
ɳSelf Docs

game-metadata

Game Metadata Plugin

Section titled “Game Metadata Plugin”

IGDB integration for game metadata. ROM hash matching, full-text search, artwork retrieval. Pro plugin.

Requires: Basic license tier or higher. nself license set nself_pro_...

Install

Section titled “Install”
Terminal window
nself license set nself_pro_xxxxx...
nself plugin install game-metadata

What It Does

Section titled “What It Does”

The game-metadata plugin connects to the IGDB API to enrich your ROM library with titles, cover art, screenshots, and platform data. It matches ROMs by hash to known game entries and caches results locally for fast full-text search without repeated API calls.

Configuration

Section titled “Configuration”
Env VarDefaultDescription
IGDB_CLIENT_IDnoneTwitch/IGDB OAuth client ID
IGDB_CLIENT_SECRETnoneTwitch/IGDB OAuth client secret
GAME_METADATA_PORT3123Port the service listens on

Ports

Section titled “Ports”
PortPurpose
3123Game metadata REST API

Database Tables

Section titled “Database Tables”

5 tables added to your Postgres database:

  • np_game_metadata_games
  • np_game_metadata_platforms
  • np_game_metadata_artwork
  • np_game_metadata_roms
  • np_game_metadata_search_cache

Nginx Routes

Section titled “Nginx Routes”
RouteTarget
/api/game-metadata/localhost:3123