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: A paid bundle license or ɳSelf+. 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 Var	Default	Description
`IGDB_CLIENT_ID`	none	Twitch/IGDB OAuth client ID
`IGDB_CLIENT_SECRET`	none	Twitch/IGDB OAuth client secret
`GAME_METADATA_PORT`	`3123`	Port the service listens on

Ports

Port	Purpose
`3123`	Game 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

Route	Target
`/api/game-metadata/`	`localhost:3123`