GameDB is a database of games, platforms, characters, collections, franchises, and videos sourced from IGDB and published as a static JSON API via GitHub Pages. Video metadata is enriched with data from the YouTube API.
The data is intended to be consumed by LizardByte projects such as Sunshine.
The database is updated automatically on a schedule via the update-db workflow.
The generated JSON files are published to the gh-pages branch and served at
https://app.lizardbyte.dev/GameDB/.
| Endpoint | Description | URL |
|---|---|---|
| Buckets | Game name search index, split by first two characters | https://app.lizardbyte.dev/GameDB/buckets/<bucket>.json |
| Characters | Individual character details and all characters | https://app.lizardbyte.dev/GameDB/characters/<id>.json |
| Collections | Individual collection details and all collections | https://app.lizardbyte.dev/GameDB/collections/<id>.json |
| Franchises | Individual franchise details and all franchises | https://app.lizardbyte.dev/GameDB/franchises/<id>.json |
| Games | Individual game details (no aggregate all.json) | https://app.lizardbyte.dev/GameDB/games/<id>.json |
| Platforms | Individual platform details and all platforms | https://app.lizardbyte.dev/GameDB/platforms/<id>.json |
| Videos | Individual YouTube video metadata | https://app.lizardbyte.dev/GameDB/videos/<id>.json |
| Stats | Total item counts per category | https://app.lizardbyte.dev/GameDB/stats.json |
all.json files (e.g. characters/all.json) contain a summary of every item in that category as a single
dictionary keyed by ID.
Buckets are used as a lightweight search index for game names. Each bucket file is named after the first two
alphanumeric characters of the game name (lowercased), e.g. ha.json for games starting with "Ha" such as
Halo. Games whose names contain a space as the second character are put into a bucket named after the first
character. Games whose names do not start with two alphanumeric characters are grouped into @.json. Each bucket
contains a dictionary of { id: { name } } entries, keeping individual files small for fast lookups.
Code contributors can use the Developer Setup guide.