.thumb.png.c9faf450e4d2b690a819048b18173f61.png)
About This File
Use this plugin to filter and import MAME Software Lists into LaunchBox.
Features:- Choose to import clones as Additional Apps, separately or not at all
- Skip Prototypes (filter option)
- Skip Non Supported games (filter option)
- Import the selected (filtered) Console/Computer games into LaunchBox
- Adds the appropriate command to each imported games' Command Line (ex. a2600 -cart)
- Copy the filtered selection of roms to a separate folder (optional)
(After copying files, they will automatically be imported)
- If a newly imported game is tagged as not supported by MAME, it will be marked as "Broken".
Will also check existing games in the Platform being imported to (in case MAME updated its' status)
*New v3.0
- New Audit Feature. Compare your existing softlist Platform against the MAME hash.xml.
Will cross check Title and Rom names.
- Select the respective hash.xml and Platform
- Click Audit (last page)
- Any differences along with a brief description will be shown.
- Option to select files (if any) and have them removed from your LaunchBox Platform.
- Will check main Titles as well as Additional Apps (if you imported them that way).
This does NOT check rom integrity. That's between you and Clrmamepro (or related utility).
What's needed:
- (2) dll files included in the zip file Starting with v2.0, only need the (1) dll file included in the zip.
- MAME Software List hash files (located in the "hash" sub folder of your Mame's main folder)
- MAME Software List roms* and BIOS files (only if you want to actually play them)
*The rom set needs to be either a Split set or a Non-Merged set for a full import
- If you plan to not import clones, any type set will work.
What it won't do:
- Filter/Sort by Region (it's a MAME hash file limitation)
- Determine if/what BIOS files are needed
- Import Metadata and Media (just use LaunchBoxs' built-in Tool)
How to:
- Copy the "ImportMameSoftwareLists" folder from the zip file to your ..\LaunchBox\Plugins folder.
- Navigate to that folder and unblock the 2 dll files. (Right click, Properties, and click Unblock)
*New in v1.31
- Start LaunchBox. Click on "Tools" and select "Import MAME Software Lists".
Note:
- The "Destination Folder" is required even if you don't plan to copy the files. It's needed to set up the Application Folder for the games when Importing.
See what's new in Change Log.
* MESS xml *
To see MAME's Overall and Emulation status [Preliminary/Good/Imperfect]in the Import Mame Software Lists plugin, you will need to have the MESS xml file that matches your version of MAME. messxxx.xml (where 'xxx' is the MAME version. i.e. mess215.xml)
This file needs to be located in the same folder as the plugin (..\LaunchBox\Plugins\ImportMameSoftwareLists\) and can be download from: http://www.progettosnaps.net/mess/
These files are [relatively] large (24MB+) and will slow down the screen updates when selecting different consoles/computers.
Use "Shrink_MESSxml.exe" to reduce the mess xml file size to a little over 1MB to eliminate slow screen updates. (April-2020 V2.0 is available. Reduces file size even more.) After 1st making a backup, it then removes unneeded data from the xml file. Place only the one 'shrunken' xml file in the plugin folder. ..\LaunchBox\Plugins\ImportMameSoftwareLists\mess215.xml (a 'shrunken' mess215.xml is included with v1.30)
The Import Mame Software Lists plugin will search for "mess*.xml". So as you update, just replace the old xml file (mess215.xml) with the new one (mess216.xml).
ONLY HAVE ONE MESS XML FILE IN THE PLUGIN FOLDER AT A TIME!
v1.32 includes mess219.xml (shrunken, of course)
Other Notes: (things I've learned)
- Software List folder/file locations:
For easiest integration with MAME, place all Software List folders inside a single directory (i.e. "software") and name them the same name as their respective hash xml file_name. For example:
D:\emulators\MAME\software\
D:\emulators\MAME\software\32x\
D:\emulators\MAME\software\a2600\
D:\emulators\MAME\software\a2600_cass\
D:\emulators\MAME\software\apple2gs\
Now, all you need to add to mame.ini in "rompath" is "software". You don't need to worry about any of the Software List sub-folders.
#
# CORE SEARCH PATH OPTIONS
#
homepath .
rompath roms;software
Assuming you still have both boxes checked ("Don't use quotes..." and "Use File name only..." in the MAME emulator settings, you'll be able to lauch these without problems*.
- *Associated Platform Command line parameters
The command lines that get placed in MAME - Associated Platforms come from hash files. However there are a few that will need to be manually edited. A couple I'm aware of are:
Apple 2GS: needs to be changed from "apple2gs -flop1" to "apple2gs -flop3"
Sony PlayStation: (though doens't work in MAME) needs to be changed from "psx -cdrm" to "psu -cdrm" (See MAME and CDROMS)
SNK NeoGeo CD: For some reason I can only get it work if the command line (neocdz -cdrm) is placed under each games "Emulation" tab in "Use Custom Command-LineParameter".
This plugin can help put that in there for you. If someone knows how to get it to work otherwise, please let me know so I don't have to look like I'm pimping my other plugins. 
- MAME and CDROMS
MAME will run (when supported) CDROMS by simply pointing the application path to the game's folder rom_name. You do not need to point to the chd file to run it. (Note: the plugin will have it point to the folder_name.zip, but with the checkbox "Use file name only..." checked, it takes off".zip".
If you wish to import CDROM games into LaunchBox for use with a different emulator, you will need to have the application path point to the games actual file_name.chd.
New Feature: When the plugin sees that the media type is CDROM, you'll be given the option to import the roms for "use with an emulator other than MAME" (Choose "Yes"). If you'll only be using them with MAME, choose "No".
What's New in Version 3.0 See changelog
Released
3.0
- Improvement: Will store your MAME emulator selection.
- Improvement: Several changes to accommodate updating softlists.
(When Copying files, must use a Full set as the Source files. Using just Update Packs may cause issues.)
- When updating a softlist Platform, will check for new or renamed Titles and roms.
- Will not remove existing Titles from your Platform that are not listed in the hash.xml.
- You will need to rename (or re-download) media for Titles that have been renamed (i.e. "Launch Box" ---fixed--> "LaunchBox").
- New Feature: Audit. Compares your existing softlist Platform against the MAME hash.xml.
Will cross check Title and Rom names.
- Select the respective hash.xml and Platform
- Click Audit (last page)
- Any differences along with a brief description will be shown.
- Option to select files (if any) and have them removed from your LaunchBox Platform.
- Will check main Titles as well as Additional Apps (if you imported them that way).
This does NOT check rom integrity. That's between you and Clrmamepro (or related utility).
2.01
- Improvement: Last used rom Source and Destination parent folder locations are now stored. (creates a new file)
- Improvement: Added PgUp, PgDn, Home and End when navigating through console/computer list.
- Bug Fixed: "Select a Computer/Console to Import" screen. Fixed error when pressing a key and not inside the files list.
- Fixed: Error if xml file contains no game info (i.e. c64_flop_clcracked.xml)
- Bug Attended to: (Again.) When executing "Import Only", would sometimes not work the 1st time.
2.0
- Brand New Look (sorta): Changed the Import Wizard to make use of existing LaunchBox resources.
This eliminates the need for an extra dll file and helps maintain consistency with LaunchBox's UI.
- Fixed: When importing Clones as Separate Apps, progress bar now shows accurate progress.
- House Keeping: Some code cleanup and improvements to (hopefully) catch any errors and be more efficient.
To upgrade to version 2.0, delete the 2 existing dll files from your ..\Plugins\ImportMameSoftwareLists\ folder and and place the new one from the zip file in their place.
Required Files:
** Versions up though v1.32 **
../LaunchBox/Plugins/ImportMameSoftwareLists/ImportMameSoftwareLists.dll
../LaunchBox/Plugins/ImportMameSoftwareLists/AdvancedWizard.dll
** Versions starting from v2.0 **
../LaunchBox/Plugins/ImportMameSoftwareLists/ImportMameSoftwareLists2.dll
1.32
- Clarification: When copying files, existing files with the same name will be overwritten.
(useful when updating Software Lists)
- Fixed: Tools menu icon.
- Fixed: Will no longer Import games that already exist.
- Fixed: If Platform already exists as an 'Additional Platform' for the MAME emulator, it won't add it again.
- New Feature: If a newly imported game is tagged as not supported by MAME, it will be marked as "Broken".
Will also check existing games in the Platform being imported to (in case MAME updated its' status)
(Not applicable to clones when imported as additional apps)
- Changed: Made changes and reduced the dll file size by about 75%
1.31.1
- Fixed error: not showing up in the "Tools" menu.
1.31
- Moved to Tools menu. Select "Tools" - "Import MAME Software Lists"
- Improvement: Added real-time progress bars for Copy and Import
- Improvement: Attempts to find your hash-files folder location automatically
- Improvement: When adding New Platform, will automatically fill in the selected Console (can be edited)
- Improvement: When running "Copy and Import", tasks run simultaneously to reduce completion time
1.30
- Fixed: When Importing into LaunchBox, progress bar indicates "Importing" instead of "Copying".
- Fixed: Removed plugin from BigBox
- Fixed: Miscellaneous Import issues
- New Feature: When importing CDROM media, the Application Path can be set to point the rom_name folder or to the roms file_name.chd for use with emulators other that MAME. (See "MAME and CDROMS")
- New Feature: Will show MAME's emulation 'status' for the selected consoles/computers [Preliminary/Good/Imperfect]. **Requires additional file. (File not required for the plugin to function. But the status will not appear.)
**To see the status, you will need to have the messxxx.xml (where 'xxx' is the MAME version: mess215.xml) file in the same folder as the plugin. (See "MESS xml")
V1.20
* Fixed 'Copy and Import' and 'Import' when creating a new Platform. (For real this time)
* Added refresh LaunchBox after plugin closes to show newly created Platform. Shouldn't need to press F5 after exiting plugin.
V1.10
* Added rom file compression format option (.zip [Default], .7z) [used for copying and command lines only]
* Changed Command-Line to remove "_xxxx". i.e. "spectrum_cass" becomes "scpetrum" (required for MAME command line)
* Added 'add platform to emulator' as Associated Platform
- Moved Command-Line from game "Custom Command-Line" to Emulator: Associated-Platform, Custom Command-Line
* Fixed 'Copy and Import' (would sometimes copy then not import)
Notes:
- Software Lists consoles use the default command-line: console_name -media_switch ["path_to\gamename.zip"]
i.e. a2600 -cart (This is automatically added when importing games)
LaunchBox adds ["path_to\gamename.zip"]
- Unlike with Arcade machines, mame.ini does NOT need to have Software List rom folders added to "rompath".
(The exception is any necessary bios files which are not included in the Copy process)
This assumes the MAME emulator does NOT have "Don't use quotes" and "Use filename only" checked. (Both boxes unchecked)
TODO:
Add driver status ("good", "imperfect", "preliminary") for console listings
