-McFly- Posted 4 hours ago Posted 4 hours ago 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. Submitter -McFly- Submitted 03/08/2026 Category Third-party Apps and Plugins Quote
Recommended Posts
Join the conversation
You can post now and register later. If you have an account, sign in now to post with your account.