Jump to content
LaunchBox Community Forums

1 Screenshot

About This File

🕹️ Database Matcher & Auditor 2.0 for LaunchBox

Database Matcher & Auditor 2. is an automated library auditing and database matching plugin for LaunchBox. It scans your game library for unmatched titles (games missing a LaunchBox Database ID) and uses a multi-threaded fuzzy matching engine to accurately find and assign their official LaunchBox DB IDs. Based on slipsystem's Launchbox Games Database Matcher idea but taken it a bit further.

Once DB IDs are assigned, you can instantly scrape missing box art, clear logos, fan art, and trailers using LaunchBox's native metadata download tools.


Key Features

  • 📊 Full Library Auditor: Instantly scans your library or specific platforms to identify unmatched games, missing box art, missing logos, and missing video snaps.

  •  Fast Indexing & Multi-Threading: Uses an in-memory inverted word index to search the launchbox database records.

  • 🧠 Smart Title Normalization:

    • Strips bracket tags (USA), disc tags (Disc 1), version strings (v1.02), and punctuation.

    • Automatically splits CamelCase & PascalCase titles without spaces (e.g., converts SuperMarioBros 

       Super Mario Bros).

       

  • 🎯 Fuzzy Matching Engine:

    • Consecutive Word Sequence Scoring: Prioritizes titles with 2 or more exact sequential matching words (e.g., matches "The Empire Strikes Back" to "Star Wars Episode IV: The Empire Strikes Back").

    • Sub-phrase & Sliding Window Detection: Handles titles embedded within series prefixes or subtitles.

    • Phonetic Penalty: Heavily penalizes false phonetic matches that lack actual word overlap.

  • 🌐 Optional Cross-Platform Matching: Toggle cross-platform searching to find matches across alternate console/arcade releases . Only use this if your not fussed about accuracy. This gives many more results and more accurate title hit rate at the cost of having other platforms art work. I figured any artwork for the game is better than none. this is off by default though. 

  • 🔍 Interactive Match Resolution:

    • You can edit cleaned titles directly in the grid and click 🔍 Search to re-query instantly for that title.

    • Double-click any game row to view up to 20 top candidate matches (top 10 current platform + top 10 cross-platform matches if enabled).

    • Assign confidence threshold slider (default: 80%) for safe bulk auto-matching. High the slider the less results but more accurate.

 

Installation : Extract the LaunchBox.DatabaseMatcher folder to the launchbox\plugin\ folder and Restart Launchbox

Currently WIndows only as far as i know.


🎯 Primary Use Cases

  1. Fixing Unmatched Imported ROM Sets: Quickly assign DB IDs to imported MAME, homebrew, custom ROMs, or Japanese/European collections.

  2. Much higher accuracy/ hitrate on malformed file titles.

  3. Metadata & Media Scraping: Fixes many more grey placeholder boxes than the standard launchbox search, by preparing unmatched games for LaunchBox's built-in media downloader and looser word scoring engine.

  4. Cross-Platform Media Fallbacks: Match obscure ports or arcade titles to console database entries when a specific platform entry is missing media.


💡 Tips for Best Results

  • Step-by-Step Workflow:

    1. Select a platform (or All Platforms) and click 1. Audit Library.

    2. Choose whether to turn on search all platforms for other game ports/versions. Warning this will give potentially inaccurate artwork, purists stay away! if in doubt leave it off.

    3. Click Search DB Matches to run fuzzy matching.

    4. Adjust the Assign Threshold Slider (80% is recommended for safe bulk auto-assignment).

    5. Click 3. Auto-Assign Matches.

    6. Click 4. Save to LaunchBox to commit changes permanently.

    7. Scan for Media/Artwork in the normal way

  • Manual Override: If a game doesn't match correctly automatically, before "Auto assign matches" edit the text in the Clean Title (Editable) column and click 🔍 Search next to that row.

  • Inspect Candidates: Double-click any row to open the candidate selection dialog and manually pick the exact DB entry you want. Non platform results will be at the bottom if enabled

  • Download Media: After saving your matches, go to LaunchBox's top menu: Tools 

     Download 
     Update Metadata and Media for Selected Games to fetch missing artwork!

 

  • If your collection is large i would suggest doing one platform at a time as searching can take a while.

What's New in Version 1.0.2   See changelog

Released

Added support for .net 9 for Stable version 13.27 compatability on windows 10.

  • Unusual Gem 2

User Feedback

Recommended Comments

Hanz

Posted

This is incredibly useful for all the homebrew and romhacks I added forever ago that have since been added to the database. Just found a ton of Game Boy stuff that has been unmatched for years at this point.

  • Like 1
Hanz

Posted

I just noticed that after running a search for database matches and going through the list to uncheck the ones I don't want, it still seems to assign those after I click Auto-Assign. Currently it says Checked/Ready to Assign 4, I unchecked 2 of them and when I hit Auto-Assign it still says 4 were assigned.

jpcheat

Posted

Thanks I'll take a look. Just to confirm, does it show the new title if you go to that particular game right click/edit metadata? If it's unchecked. It shouldn't apply any that aren't checked, even though it shows the new matched title in the plugin. So might be a bug if so.

hapnlater

Posted

I am incredibly angry trying to get this even show up. Ill agree im not very informed but I cant for the life of me see anything different. Just the normal audit function. What am i doing wrong?

jpcheat

Posted

Assuming your running the latest launchbox version and on windows? As long as you place the plugin folder in the correct folder: launchbox\plugins\LaunchBox.DatabaseMatcher\LaunchBox.DatabaseMatcher.dll it should appear. 
If not you may have got a security warning. If so, right click on the plugin.dll in the folder and choose properties. then check the little "unblock" box. then restart launchbox. check windows defender isn't interfering also.
In launchbox check Tools/Manage/Plugins. See if it appears there and is enabled. It should appear here:

image.thumb.png.10a2814371e6f7cbc633ff2433133d1f.png

jpcheat

Posted

@Hanz

Turns out because of the (OR) condition, if a game's confidence score was above the threshold (e.g. 85%), it evaluated to true. As a result, even if you manually unchecked the box , it ignored the checkbox state and assigned the match anyway. The Checkbox is now the Single Source of Truth and overrides the initial search match. So should be fixed now. let me now.

  • Thanks 1
Hanz

Posted

Great! Ill give it a look after i get the kids to bed tonight. This sort of thing is a must have for anyone who has been curating a collection for years. You are bound to have unmatched stuff lying around you would normally overlook. 

espidie79

Posted

Hello jpcheat.

I have the same issue that hapnlater has. I´ve followed your explanations. I have unblocked the archive and is in the correct folder. but it doesnt show up in tools

I´m running windows 10 with launchbox 13.27

 

Thanks a lot

 

jpcheat

Posted (edited)

@espidie79 you say you've unblocked the archive? Do you mean you've extracted the zip archive into the correct folder and unblocked the dll in properties? Wondering if it's a windows 10 thing. Will look into it. I'm only running windows 11 so that's the only other thing I can think of as to why it's not showing up for you. Try adding the entire launchbox folder as an exception in windows defender.

Update: the latest beta of Launchbox runs on .net 10, so this plugin is written for Launchbox 13.28 (.net 10.0). Launchbox 13.27 is still running .net 9.0. So I've now built it in .net 9 for compatibility. with the latest stable version. I think that was the issue. Windows 11 installs .net 10 with windows update so guessing that was why it worked on other peoples. So try v1.02 now and see if it now works for you.

Edited by jpcheat
Hanz

Posted

Works perfectly now. I was able to uncheck all the ones I didn't want and it didn't assign others.

If I had one more suggestion it would be to allow sorting in the checkbox column. I went through a large platform and wanted to easily see what was checked before I went through with it but clicking that header didn't seem to do anything.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Unfortunately, your content contains terms that we do not allow. Please edit your content to remove the highlighted words below.
Add a comment...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...