Jump to content
LaunchBox Community Forums

Recommended Posts

Posted

Launchbox Doctor - Audit Tool

View File

LaunchBox Doctor v1.0

Repair, audit, and verify LaunchBox installations

Author: Mcfly

LaunchBox Doctor scans your LaunchBox installation and repairs common structural issues that can break LaunchBox, BigBox, or large collections.

It was built specifically for large libraries and multi-drive setups, including collections using junctions, symbolic links, or split storage across multiple drives.


What LaunchBox Doctor Does

LaunchBox Doctor performs several checks and repairs:

• Detects missing or broken symbolic links / junctions
• Repairs missing game folder links
• Detects missing or invalid media paths
• Verifies LaunchBox XML structure integrity
• Identifies orphaned or unreachable content
• Identifies missing Platform and Playlist videos

The script can recreate missing junctions automatically if the source folders exist.


Why This Exists

Large LaunchBox collections (especially multi-drive setups) often use:

• Junction links
• Symbolic links
• Split storage across drives
• Network shares

If one of those links breaks, LaunchBox may suddenly show missing games, empty platforms, or startup errors.

LaunchBox Doctor helps identify and repair those problems quickly.


Typical Problems This Script Fixes

Examples of issues LaunchBox Doctor can detect or repair:

• Platform suddenly showing 0 games
• Games missing after drive letter change
• Broken LaunchBox\Games junctions
• LaunchBox failing to load certain platforms
• Broken symlink libraries after drive reconnect
• Incorrect folder mappings


Safety

LaunchBox Doctor is designed to be non-destructive.

The script:

Does not delete games
Does not modify ROM files
• Only recreates missing links when the source exists

If a required source folder cannot be found, the script will skip it and report the issue instead of making changes.


Requirements

• Windows
• PowerShell
• Administrator privileges (required for junction creation)

LaunchBox / Bigbox itself should not be running while the script runs. 


How to Run

Place the script anywhere and run it with PowerShell as an Administrator inside that location:

                     powershell -ExecutionPolicy Bypass -File .\LaunchBox-Doctor-v1.0.ps1
Follow the prompts to select your LaunchBox installation and check paths.
The script itself can be updated with these paths using Notepad, although last-run paths are remembered.

Example Use Case

Example scenario:

You store games across multiple drives:

H:\LaunchBox\Games
K:\LaunchBoxGames
J:\LaunchBoxGames
LaunchBox Doctor can detect if a junction under LaunchBox\Games has broken and automatically recreate it pointing to the correct location.

Typical Output

See example image.

 

Recommended Usage

Run LaunchBox Doctor if you experience:

• Missing platforms
• Empty game lists
• Broken junction libraries
• Problems after moving drives
• Issues after rebuilding storage
• Missing Platform or Playlist videos

It can also be useful as a quick audit tool for very large LaunchBox installations.


Notes

If you use:

• NAS storage
• Multiple SSD/NVMe drives
• Junction-based libraries

this script can save a lot of time when troubleshooting missing content.


Feedback

This tool was written to support large LaunchBox collections.
If you find bugs or have improvement ideas, feel free to post feedback.

Launchbox Doctor dropped in D then ran.png

Launchbox Doctor running - menu.png

Launchbox Doctor running all tasks (dry run).png


 

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.
Reply to this topic...

×   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...