Using rsync to Update Your MAME ROM Collection

Guide Utilities by sky

Comparaison de pommes
The purpose of this guide is to show how to merge the MAME ROM collection with the differential update folder using `rsync`, a terminal command.

This article is therefore aimed at users who are not afraid of playing with command lines

If you are not familiar with the `rsync` command, you can start by taking a look here.

Every last Wednesday of the month, the team in charge of MAME, the multi-arcade emulator, releases a new version of its application. With each new version, the emulation of certain games changes, and it is necessary to update the ROMs of the corresponding games.

However, the complete MAME collection weighs several tens of gigabytes, so it is preferable to retrieve only the differential update.

This is where `rsync` comes into play, as it will allow merging the existing collection folder with the update folder, instead of doing this work manually.

In a terminal, the command I use is:

rsync -a /Chemin/vers/dossier/mise-a-jour/ /Chemin/vers/romsets/MAME

Of course, you must replace the example paths with the actual paths of your folders.

Small tip: You can drag the folders one after the other, after typing `rsync -a` with a space between them.

As indicated in the rsync tutorial, it is important to correctly place the trailing slash of the differential folder to avoid ending up with that folder inside your collection.

This would be as simple as copying a folder into another, which is entirely unnecessary and doesn’t require `rsync`. Thus, all files in the update end up in the romset, including elements from the `CHD` and `SL` folders, if you keep them in the same location. If you want more information about the transfer, you can add the `-vh` and `--progress` parameters to the command: plaintext rsync -avh --progress /Chemin/vers/dossier/mise-a-jour/ /Chemin/vers/romsets/MAME The `-v` parameter will detail the copy of each file, while `--progress` will show the progress of each copy, useful for large files like `CHD`. Finally, the `-h` parameter ensures that the values displayed in "progress" are human-readable, using K(ilo), M(ega), G(iga) instead of bytes. It’s not any more complicated than that.

Related software

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum