Skip to content

Signatures

Michael Green edited this page Jul 22, 2024 · 4 revisions

Signatures are used to match a ROM to a game name using the hash of the ROM (MD5 or SHA1). Without access to a signature database, Gaseous will attempt to "guess" the game name from the file name.

Local Signatures

This is the default method.

Local signatures are also always checked if no other source (see below) is available, enabled, or able to provide a match.

Currently supported DAT's:

If there are other DAT's you'd like to see support for, please raise an issue with a link to the DAT's.

Adding signature DAT files to the local database

TOSEC

  1. Download the DAT files from the source website. For example; from https://www.tosecdev.org/downloads/category/56-2023-01-23
  2. Extract the archive
  3. Copy the DAT files to ~/.gaseous-server/Data/Signatures/TOSEC/

MAME Arcade

  1. Download the DAT files from the source website. For example; from https://www.progettosnaps.net/dats/MAME
  2. Extract the archive
  3. Copy the file name MAME 0.257 (arcade).dat files to ~/.gaseous-server/Data/Signatures/MAME Arcade/

MAME MESS

  1. Download the DAT files from the source website. For example; from https://www.progettosnaps.net/dats/MAME
  2. Extract the archive
  3. Copy the file name MAME 0.257 (mess).dat files to ~/.gaseous-server/Data/Signatures/MAME MESS/

NOTE: In Gaseous versions prior to v1.7.6 there was a bug where MAME and MESS DATs would not import correctly. If DATs were imported prior to v1.7.6, they may be incomplete.

To resolve this, the record of having imported the DAT needs to be deleted:

  • Upgrade to 1.7.6 if you have not already done so
  • Navigate to the Swagger API page. This will be http(s)://<your host>:<your port>/Swagger/
  • Scroll to the section called Signatures
  • Expand the row with the end point /api/v1.1/Signatures/GetSignatureSources
  • Click "Try it out"
  • Click "Execute"
  • In the responses section a row with the code 200 should appear
  • Find the entries with the sourceType set to MAMEArcade or MAMEMess and take note of the id for each
  • Expand the row with the end point /api/v1.1/Signatures/DeleteSignatureSource
  • Click "Try it out"
  • Enter the id of the first source to delete and click "Execute"
  • Repeat for each id to delete
  • Once complete, follow the instructions above (https://github.com/gaseous-project/gaseous-server/wiki/Signatures#adding-signature-dat-files-to-the-local-database) to re-import the DATs.

Other Signature Sources

Note: This is still experimental.

Hasheous (removed in v1.7.3 and will return in v1.8.0)

Hasheous is an open source project that provides an API that Gaseous can access to match a ROM hash to a game title. It also (at the time of writing) provides IGDB match information for hashes that have been submitted before. This can result in a much faster match when importing ROMs. See: https://github.com/gaseous-project/hasheous

There are two config.json options required to enable:

  • SignatureSource set to Hasheous
  • HasheousHost set to a Hasheous server URL. The current project server is hosted at https://hasheous.org/