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

Example Use Case

Example scenario:

You store games across multiple drives:

H:\LaunchBox\Games
K:\LaunchBoxGames
J:\LaunchBoxGames

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.