Skip to main content

game-metadata

game-metadata — ɳSelf documentation.

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

nself license set nself_pro_xxxxx...
nself plugin install game-metadata

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

Env VarDefaultDescription
IGDB_CLIENT_IDnoneTwitch/IGDB OAuth client ID
IGDB_CLIENT_SECRETnoneTwitch/IGDB OAuth client secret
GAME_METADATA_PORT3123Port the service listens on

Ports

PortPurpose
3123Game metadata REST API

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

RouteTarget
/api/game-metadata/localhost:3123