clrmamepro is a tool that checks your ROMs against a database. It reports any missing or incorrect data and can correct some errors.

This is important because MAME and its variants refuse to run any software that isn't in its database, which changes with every version. Even with emulators that run any ROM, you should know which ROMs are good and bad and have them properly identified. Processing ROM sets with clrmamepro is much more efficient than manually managing the files.

This guide only explains the core functions and basic usage of the program. See index.htm in its docs folder for more detail.

Another guide can be found here: http://www.mameworld.info/easyemu/clrmameguide/clrmame-menu.html

• Create a new profile
• Configure settings
• Scan
• Review the results
• Rebuilder
• Keeping multiple arcade profiles
• Other profiles
• Updating profiles

Download the program. There are 32-bit and 64-bit flavors available, in installable (exe) and portable (zip) form. Install or extract it and run it.

Create a new profile

clrmamepro starts in Profiler mode, where you designate a database to use. The two ways to do this are to feed a prepared datfile to the profiler, or to to extract a dat directly from the emulator binary.

The second method saves you the step of getting a separate dat but can only be used with a few emulators. It works with MAME so we'll do that now. Click Create and browse for the MAME binary. Put the version in the description and click Create Profile.

If you want to manage other sets you may want to put this profile in a subfolder just for MAME.

Now select the new profile from the tree on the left and the list on the right. Click Load / Update and then OK to the database update prompt.

This step will take some time and will stop a few times with warnings or questions. Pick OK TO ALL and Yes to All to clear them.

You still have to tell the program where your ROMs are, so click Settings in the main window.

Configure settings

Pick ROM-Paths from the dropbox, click Add, and browse to where your ROMs are. Add as many folders as necessary. You can also drag and drop instead of browsing.

clrmamepro will see anything in those paths that isn't in the dat as a bad ROM. If you keep subfolders in your ROM folders with unrelated files, pick Exclude-Paths from the dropbox and add those subfolders. To ignore individual files, pick Unneeded-Masks and add the filenames, with wildcards like *.txt if desired.

Click the X to return to the main menu. Click Scanner.

Scan

Sets are the zipfiles that contain individual ROMs. You'll want both of those checked. CHDs are like ROMs but larger, and their files are placed in subfolders rather than zips. They come from media like hard disks and CDs and are compressed according to their own format. Many popular games require CHDs so you'll probably want to leave this checked. Samples are audio recordings to supplement older games with unemulated sound. If you don't have any you want scanned, uncheck Samples. If you do, you'll need to define paths for them back in Settings.

MAME dats organize games that share data, such as regional variants of the same game, into families. One of the members is arbitrarily selected as parent and the rest are clones. There are three ways to handle game families: Non-Merged Sets means that all games, including clones, have all the data needed to run copied into their zipfiles. Merged Sets means that there's only one zipfile for each family, with the clones moved in with the parents. In practice everyone uses Split Sets, which keeps parents and clones in separate zipfiles without duplicating the redundant parent data. (Sets may also be kept uncompressed in subfolders rather than zipfiles.)

To set the scanner to fix everything it can, click the small button under Fix to fill all the boxes. To just check and report, click the button to clear all the boxes. If the scanner is told to fix Unneeded, then unrecognized files and bad ROMs will be moved to the backup folder, specified in Settings. If the other fix options are enabled, clrmamepro will correct any wrong ROM file and zipfile names and move ROMs to the correct zipfile if they are wrongly placed.

With Ask before Fixing enabled, clrmamepro will stop to prompt you whenever it encounters something it can fix. Uncheck it to fix automatically.

Click New Scan to begin. This process may take awhile.

Review the results

The Scan Results window shows info on a set-by-set basis. Only sets with problems are shown.

You can access a menu of things to do with this information by right-clicking in the results window. If you have a small subset of the collection, you may want to enable View > Hide Fully-Missing Sets. Changes to viewing options may not take effect until the next scan.

Click the Set Information button to open another window with more in depth information about the status of all the sets.

The Statistics window pops up if Add/Show Statistics was checked or if you click the Statistics button. It reports the overall status of the profile, like how many ROMs are missing, and what problems were found and fixed.

Any unneeded files that were fixed were moved to the profile's backup folder, which is defined in Settings.

The initial scan creates a cachefile for the profile, which enables the Scan button. Clicking this button skips the sets that had no problems and is faster than New Scan.

Rebuilder

So you obtained missing files to add to the profile. Use the Rebuilder to do the adding.

The Rebuilder examines each file you pass to it, checks it against the dat, and either incorporates it into the sets or ignores it if unrecognized.

You can type or browse the location of the files to be processed in Source, but it's easier to drag and drop onto the Rebuilder window. If you suspect that the Scanner discarded some good files, click the UseBackupPath button to make the Rebuilder recheck them. By default the destination is the first ROM path defined in Settings.

Merge options are the same as in the Scanner. The Compress Files option can be disabled to yield subfolders instead of zipfiles. There's no need to use Recompress Files. Enabling Remove Matched Sourcefiles moves the good files from source to destination, while disabling it makes copies instead.

After the rebuild, statistics are shown.

You may wish to return to the Scanner to rescan the profile now. Click the left radio button in the lower-right corner of the window for a shortcut to switch over.

Keeping multiple arcade profiles

Some ROMs may be different between different versions of MAME/FBA. If you need to run the same games on different versions, you may have to keep multiple versions of those games. Simply create a profile for each emulator and give them different ROM paths in their respective Settings.

Other profiles

The techniques here can be used to keep track of other dats besides MAME. For example, no-intro and redump.org maintain software databases via dat files, and FBA can create a dat for itself from the menu with Misc > Generate dat file > XML ClrMame Pro format > Generate dat.

To add a dat, click Add DatFile in the profiler, then browse to the dat you obtained. Pick a folder and click OK to create the profile. An alternative way to add a dat is to place it directly where you want it in the datfiles subfolder of clrmamepro's directory, then click Refresh List in the Profiler.

Click NEW DATFILES in the pane on the left and then the new profile on the right. Click Load / Update to commence the same procedure as above.

Updating profiles

Stay up to date with new versions of your profile.

If the dat for the profile was extracted directly from an emulator, simply overwrite the old binary with the new. Select the old profile in the profiler and click Load / Update. clrmamepro will detect the change and prepare a new datfile.

If the dat was downloaded, follow the same procedure for adding it as a new dat. When you attempt to load the new profile, clrmamepro will detect that it is an update and proceed accordingly.

After updating a profile that has already been scanned, the Diff Scan button becomes available in the Scanner. This scans only sets that changed in some way since the last version, so it's faster than a New Scan