Amiberry WHDLoad Game Database

Structured game compatibility database for Amiberry, the Amiga emulator.

Contains hardware settings, controller mappings, and WHDLoad slave metadata for 11,000+ games.

Download

The database is available as a JSON file, served via GitHub Pages:

https://db.amiberry.com/whdload_db.json

Format

The database uses JSON with structured, typed fields:

{
  "schema_version": 2,
  "game_count": 11041,
  "games": [
    {
      "filename": "Turrican2_v1.3_Psygnosis",
      "sha1": "abc123...",
      "name": "Turrican II",
      "subpath": "Turrican2",
      "slave_default": "Turrican2.slave",
      "slaves": [
        {
          "filename": "Turrican2.slave",
          "datapath": "data",
          "custom_fields": []
        }
      ],
      "hardware": {
        "primary_control": "joystick",
        "port0": "joy",
        "port1": "joy",
        "screen_autoheight": true,
        "screen_centerh": "smart",
        "screen_centerv": "smart"
      }
    }
  ]
}

See schema/whdload_db.schema.json for the full JSON Schema.

Contributing

Submit game settings

Use the Game Settings Update issue template to submit or update settings for a game.

Direct contributions

1. Fork this repo
2. Edit whdload_db.json (or add an override in overrides/)
3. Submit a PR — CI will validate the JSON against the schema

Building from Source

The database can be rebuilt from WHDLoad LHA archives using the included builder. See builder/README.md for setup instructions, including automated cron job configuration.

Data Source

Currently synced daily from HoraceAndTheSpider's Amiberry-XML-Builder and converted to JSON. Being migrated to a self-hosted builder that scans LHA archives directly.

License

Database content: community-contributed game compatibility data. Tooling: MIT License.