GameID

Identify a game using GameDB. Supported consoles:

• GB - Nintendo Game Boy
• GBA - Nintendo Game Boy Advance
• GBC - Nintendo Game Boy Color
• GC - Nintendo GameCube
• Genesis - Sega Genesis
• N64 - Nintendo 64
• NeoGeoCD - SNK Neo Geo CD
• PS2 - Sony PlayStation 2
• PSP - Sony PlayStation Portable
• PSX - Sony PlayStation
• Saturn - Sega Saturn
• SegaCD - Sega CD
• SNES - Super Nintendo Entertainment System

Usage

For manually checking individual games, we recommend using the GameID web app. For bulk/programmatic lookups, we recommend using the command line Python script, GameID.py:

usage: GameID.py [-h] -i INPUT -c CONSOLE [-d DATABASE] [-o OUTPUT] [--delimiter DELIMITER] [--prefer_gamedb]

options:
  -h, --help                         show this help message and exit
  -i INPUT, --input INPUT            Input Game File (default: None)
  -c CONSOLE, --console CONSOLE      Console (options: GC, N64, PS2, PSX) (default: None)
  -d DATABASE, --database DATABASE   GameID Database (db.pkl.gz) (default: None)
  -o OUTPUT, --output OUTPUT         Output File (default: stdout)
  --delimiter DELIMITER              Delimiter (default: '\t')
  --prefer_gamedb                    Prefer Metadata in GameDB (rather than metadata loaded from game) (default: False)

If the database (db.pkl.gz) is not provided via -d, it will be downloaded from this repo. This is very slow, so we strongly recommend providing it if you are running GameID in bulk (or if your environment does not have internet connection).

This tool is being actively developed, and updates will be pushed somewhat frequently. As such, be sure to periodically git pull an up-to-date version of this repository to ensure you have access to all of the latest features and optimizations.

Example: Identify a Game

./GameID.py -d db.pkl.gz -c <CONSOLE> -i <GAME_FILE>

Example: Identify All PSX Games in Directory (recursive)

find psx_games/ -type f -iname "*.cue" -o -iname "*.iso" | parallel --jobs 8 ./GameID.py -d db.pkl.gz -c PSX -i "{}" ">" "{}.meta.txt"

Build Database

rm -f db.pkl.gz && ./scripts/build_db.py db.pkl.gz

Acknowledgements

• Thanks to MiSTer Addons for the idea and for help with testing!
• Thanks to Artemio Urbina and the other developers of the 240p Test Suite, which we use as example files!
• Thanks to Daniel Ji for creating the Pyodide web app!
• Site favicon by open source project Twemoji licensed under CC BY 4.0.