mame_listxml
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionNext revisionBoth sides next revision | ||
mame_listxml [2020/08/15 19:37] – created gordonj | mame_listxml [2022/11/20 10:13] – johnsanc | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== How to create MAME sets with RomVault ====== | ====== How to create MAME sets with RomVault ====== | ||
+ | RomVault will allow you to build, repair, or upgrade a MAME collection in a few easy steps: | ||
- | It is possible with RomVault | + | - Set up RomVault |
- | (I have work hard with RomVault and the source of the DATs for the Pleasuredome MAME sets to check that these sets are fully compatible with each other.) | + | - Add MAME DATs |
+ | - Configure directory settings | ||
+ | - Scan your ROM sets | ||
+ | - Fix your ROM sets | ||
+ | - Keep your ROM sets up-to-date | ||
- | The three ways to collect MAME sets are: | + | \\ |
- | * Merged | + | ===== Set up RomVault for the first time ===== |
- | * Non-Merged | + | |
- | * Split | + | |
- | To validate these sets: First you need the XML file from the MAME.exe you are wanting | + | If you do not have RomVault installed yet, then the first step is to set it up and assign your DatRoot, RomRoot, and ToSort directories. Review the wiki page for [[install_and_setup|Windows]] or [[linux_setup|Linux]] setup instructions to get started. |
- | Or you can extract it directly from MAME like this (don't you powershell, use cmd.exe): | ||
- | {{: | + | \\ |
+ | ===== Add MAME Arcade DATs ===== | ||
- | You should then put this file into the DatRoot directory structure where you are collecting the MAME set. | + | Once you have RomVault initially set up its time to add MAME DATs. You can either provide your own or download them directly from DatVault, which is RomVault' |
+ | - Open DatVault by right clicking the **Update DATs** button or selecting **Update DATs > DATVault Update** from the top menu | ||
+ | - Enable the **Show Available** and **Show Got** status filters in the left panel | ||
+ | - Expand the **Emulators** group | ||
+ | - Select **MAME** if you want DATs for the latest stable build or **MAME-Daily** for the latest development build | ||
+ | - Decide which MAME Arcade DATs you want to use for ROMs and CHDs. For this guide we will use **MAME ROMs (listxml)** since it provides flexibility to change merge settings and allows ROMs and CHDs to be stored together which is the prevailing MAME recommendation. Refer to the table below for additional information and use cases for each DAT. < | ||
+ | ^ DAT ^ ROMs ^ CHDs ^ Description | ||
+ | | MAME CHDs (merged) | ||
+ | | MAME ROMs (listxml) | ||
+ | | MAME ROMs (merged) | ||
+ | | MAME ROMs (non-merged) | ||
+ | | MAME ROMs (split) | ||
+ | </ | ||
+ | - Select the checkbox in the row for the **MAME ROMs (listxml)** DAT | ||
+ | - Click the **Add Selected** button \\ < | ||
+ | {{: | ||
+ | </ | ||
+ | - Choose a location in your DatRoot to store the DAT. You can use DatVault' | ||
+ | - Review the DAT path in the preview box, and once it looks good click the **OK** button \\ < | ||
+ | {{: | ||
+ | </ | ||
+ | - The DAT should download and the row will be highlighted green. If you deselected the automatic download option when choosing a DAT location, then click the **Update Selected** button to download. | ||
+ | - Close the DatVault window and RomVault will automatically refresh your DATs | ||
- | Next head over to RomVault UI and scan in this DAT. (Click on Update DATs) This will load this XML file but not yet with the required setup. | ||
- | So now select and then right click on the MAME (Merge) row in the tree, and click on 'Set Dir Settings' | + | \\ |
+ | ===== Configure directory settings ===== | ||
+ | Once you have the MAME DAT downloaded and loaded into RomVault it will appear in the tree panel. The next step is to review and update directory settings for the MAME DAT. In this example we will assume that you want to store MAME in **// | ||
- | The 'Set ROM Directories' | + | RomVault's directory |
- | Merge Type: Set to 'Merge' | + | - Right click the MAME directory in the tree |
- | ROM/CHD Filter: | + | - Select **Set Dir Settings** from the context menu |
+ | - Choose a directory location for your MAME sets if you plan to store them in a location outside of everything else. For example, assume you have your RomRoot assigned | ||
+ | - Choose the following DAT Rule Settings | ||
+ | * Archive Type: **Zip** (Its best to store MAME sets in .zip format) | ||
+ | * Merge Type: **Merged** (See the dedicated documentation for more details about [[merge_types|merge types]]) | ||
+ | | ||
+ | * Header Type: **Optional** (Not relevant for MAME, so just leave this as Optional) | ||
+ | - Click the **Apply** button to save the rule | ||
+ | - Close the directory rule window and the DAT will be reprocessed automatically < | ||
+ | {{: | ||
+ | </ | ||
- | Click ' | ||
+ | \\ | ||
+ | ===== Scan your ROM sets ===== | ||
- | If you fix your mame set using these settings you will have a Pleasuredome torrent compatible Merged Set. | + | Now that you have your MAME DAT setup correctly, its time to scan and fix your MAME sets. |
- | You can also set the Merge Type to either Non-Merged or Split, to match the other two types of full mame torrents published on Pleasuredome. | + | - Select **MAME** in the tree |
+ | | ||
+ | - Click the **Scan ROMs** button. RomVault will decompress and hash all archives | ||
+ | |**ⓘ NOTE:** \\ chdman.exe is required to decompress and verify the contents of MAME V5 CHD files. chdman.exe should be placed in the same directory as the RomVault application. This is optional, but recommended. | | ||
- | It is also possible to validate the MAME CHD set using this same method. Start by copying the mame.xml output into the required DatRoot directory: | + | \\ |
+ | ===== Fix your ROM sets ===== | ||
+ | After the scanning process is complete, its time to fix your MAME ROM sets. | ||
- | Then set the two directory settings to ' | + | - Click the **Find Fixes** button. RomVault will compare the information in the DAT with the files you have scanned. |
+ | - Review the fixes RomVault determined are necessary. Refer to the [[color_key|color key]] to learn more about each ROM status and fix action. | ||
+ | - Click the **Fix ROMs** button. RomVault will start performing fixes by moving files, repacking archives, and removing unnecessary files. | ||
+ | - When the process is complete, click the **Close** button in the status log window. | ||
+ | Congratulations! You should now have a clean MAME Arcade set that matches the DAT. | ||
- | Click apply to confirm this change and then scan & fix your CHD' | + | |**ⓘ NOTE:** \\ RomVault' |
+ | \\ | ||
+ | ===== Keep your ROM sets up-to-date ===== | ||
+ | Chances are you will periodically update your MAME ROM set whenever there is a new version available. You can do this in a few simple steps: | ||
- | Following this process will give you correctly matching sets to any of these main DAT sets and torrents from Pleasuredome: | + | - Open DATVault and click **Update Selected** |
+ | - Close DATVault | ||
+ | - Add an update pack of ROMs and CHDs to your ToSort directory | ||
+ | - Select only the ToSort directory in the tree. Since our old MAME set is already scanned there is no reason to scan it again. | ||
+ | - Click the **Scan ROMs** button and the new files in your ToSort directory will be hashed | ||
+ | - When scanning is complete, keep the ToSort directory selected, and also select the MAME directory | ||
+ | - Click the **Find Fixes** button | ||
+ | - After fixes are found and reviewed, click the **Fix ROMs** button | ||
+ | That's it! You just successfully upgraded your MAME ROM set. |
mame_listxml.txt · Last modified: 2023/07/04 08:18 by johnsanc